Overview
You can use the Log Depot add-on product to securely store file-based application logs with Armor for up to 13 months. Log Depot does not provide security analysis, parsing, or awareness of log content.
Within the Armor Management Portal (AMP), you can view logs from the previous 90 days. You can view these logs and overall storage usage in the Log Search section of the Log Management screen.
Log Depot can help you meet compliance requirements.
Log Depot can only collect single-line log formats.
You can only store up to 10,000 logs, regardless if you do not reach the 90-day limit.
Pricing information
Log Depot's prices are based on a subscription (base) charge and an overage (tiered) charge.
The monthly subscription charge includes up to 25GB of storage. Additional storage above 25GB will be charged on a tiered level.
Review the following table to understand the pricing structure:
| SKU | $/Month | £/Month | |
|---|---|---|---|
| LD Base Subscription | $200 | £155 | |
| $ per GB | £ per GB | Tier Discount | |
| 0GB - 25GB (Included in Base Subscription) | Included (is $8/GB) | Included (is £6.20) | - |
| 26GB - 50GB | $7.2 | £5.58 | 10% |
| 51GB - 100GB | $6.56 | £5.08 | 18% |
| 101GB - 250GB | $6.08 | £4.71 | 24% |
| 251GB - 500GB | $5.60 | £4.34 | 30% |
| 501GB - 1000GB | $5.28 | £4.09 | 34% |
| 1001GB+ | $5.12 | £3.97 | 36% |
Order Log Depot
- In the Armor Management Portal (AMP), on the left-side navigation, click Security.
- Click Log Management.
- Click Log Source.
- Under the table, click Activate Log Depot.
- Review the product information, and then click Purchase.
- After you begin the purchase process, you can start sending logs to Armor.
Send logs to Armor
Windows users
To use these instructions, you must have powershell admin access.
- Log into a server instance that contains the Armor Anywhere - Security Agent.
- Stop the agent with the following command:
- spsv armor-agent
- Run the agent policy command to add log policies. You can use the following commands as an example:
For filelog type, run C:\.armor\opt\armor policy filelog add --path C:\inetpub\logs\web1.log --category web --tags web1,iis
- For eventlog type, run C:\.armor\opt\armor policy eventlog add --name Application --category app --tags app
- Category is required. You must label your logs based on one of the following categories: app, db, machine-data, platform, user, or web.
- Tags are optional.
- Sync the agent's policy to the API with the following command:
- C:\.armor\opt\armor policy filelog sync
- C:\.armor\opt\armor policy filelog sync
- Restart the agent with the following command:
- sasv armor-agent
- (Optional) To review any Log Depot files in AMP:
- In the Armor Management Portal (AMP), on the left-side navigation, click Security.
- Click Log Management.
- Click Log Search.
Linux users
To use these instructions, you must have sudo access.
Review the following example to understand how to send logs to Armor: /opt/armor/armor policy filelog add --path /var/log/dpkg.log --category platform --tags Ubuntu
| Text | Description |
|---|---|
| /opt/armor/armor policy filelog add | Base script |
| --path /var/log/dpkg.log | The location of the files. |
| --category platform | The type (category) of logs. You must label your logs based on one of the following categories: app, db, machine-data, platform, user, or web. |
| --tags Ubuntu | In the Log Search screen, you can search by tags. Tags are optional. |
- Log into a server instance that contains the Armor Anywhere - Security Agent.
- Stop the agent with the following command:
- service armor-agent stop
- service armor-agent stop
- Run the agent policy command to add log policies. You can use the following command as example:
- /opt/armor/armor policy filelog add --path /var/log/app.log --category app --tags app,app1
- Category is required. You must label your logs based on one of the following categories: app, db, machine-data, platform, user, or web.
- Tags are optional.
- /opt/armor/armor policy filelog add --path /var/log/app.log --category app --tags app,app1
- Sync the agent's policy to the API with the following command:
- /opt/armor/armor policy filelog sync
- /opt/armor/armor policy filelog sync
- Restart the agent with the following command:
- service armor-agent start
- service armor-agent start
- (Optional) To review any Log Depot files in AMP:
- In the Armor Management Portal (AMP), on the left-side navigation, click Security.
- Click Log Management.
- Click Log Search.
Review additional agent-related commands
Review the following table to better understand how to interact with the agent via the command line:
| Command | Description |
|---|---|
| armor -h | Displays the agent's help dialog |
| armor policy -h | Displays the agent's policy help dialog |
| armor policy filelog -h | Displays the agent's policy filelog help dialog |
| armor policy filelog add -h | Displays the agent's policy filelog add help dialog |
| armor policy filelog --add [path] | Adds a filebeat logging policy with the user-defined path, category, and tag(s). |
| armor policy add eventlog [name] | Adds a (Windows) eventlog logging policy with the user-defined path, category, and tag(s). |
| armor policy remove filelog [path] | |
| armor policy show | Displays command functionality and syntax available at the command line. "show" can be added to any level of command to help drive user input |
| armor policy sync | Synchronizes the local Armor CORE Agent with API services to pull down the latest policy version |
Troubleshoot Log Search section of the Log Management screen
If you do not see any data in the Log Search section of the Log Management screen, consider that
- You did not order the Log Depot add-on product.
- You did not properly sync Log Depot to collect your log files.
- The selected date range does not contain any data.
- You do not have permission to view log data.
- You must have the Write LogManagement permission enabled to access the Log Search section. Contact your account administrator to enable this permission. To learn how to update you permissions, see Roles and Permissions.