Introduction
Log Archiving allows you to forward logs from OpsRamp to your own cloud storage system for long‑term retention. This helps you meet compliance requirements, support audits, and investigate historical application or infrastructure issues without keeping logs in hot storage. Currently, OpsRamp supports log archiving only to Amazon S3.
Accessing Log Archiving Settings
To configure log archiving:
- Navigate to Infrastructure > Logs.
- Click the menu icon and select Logs Configuration.
- Open the Settings tab.
- Select the Archiving sub‑tab.
The Archiving page displays the available options to forward logs to external storage.

Configuring Log Archiving
On the Archiving page, provide the following information:
| Field | Description |
|---|---|
| Cloud Storage | Select the cloud storage provider. Currently, only AWS is supported. |
| Bucket Name | Enter the name of the Amazon S3 bucket where archived logs will be stored. The bucket name must be in lowercase. |
| Region | Select the AWS region where the S3 bucket is hosted (for example, us-east-1 or ap-southeast-3). |
| External ID | (Optional) An external ID used during AWS IAM role creation. This value must be entered in the AWS console when configuring the role. |
| Role ARN | Enter the ARN of the IAM role that allows OpsRamp to write logs to the S3 bucket. |
| Filter | (Optional) Define conditions to archive only logs that match the specified criteria. If no filter is configured, all client logs are archived. |
After entering the required details, click Save.
Filtering Logs for Archiving
OpsRamp allows you to optionally filter which logs are archived.
Filter Option
- Click + Filter to add a filter condition.
- Only logs that match the specified filter criteria are forwarded to the S3 bucket.
- The filter is optional:
- If no filter is configured, all logs associated with the client are archived.
- Filters apply only to AWS S3 archiving, which is the only supported storage option at this time.
This option helps you control storage costs and archive only the logs that are relevant for compliance or long‑term analysis.