GuidesChangelog
ProductDeveloperPartnerPersonal

Enable Logging to a Cisco-managed S3 Bucket

Prerequisites

  • Full administrative access to the ISP console
  1. Navigate to ISP Settings > Log Management and select Use a Cisco-managed Amazon S3 bucket.
978
  1. Select a Region and a Retention Duration.
975
  • Select a Region—Regional endpoints are important to minimize latency when downloading logs to your servers. The regions match those available in Amazon S3, however not all regions are available. For example, China is not listed.
    Pick the region that's closest to you from the dropdown. If you wish to change your region in the future, you will need to delete your current settings and start over.
  • Select a Retention Duration—Select 7, 14, or 30 days. Beyond the selected time period, all data will be purged and cannot be retrieved. We recommend a smaller time period if your ingestion cycle is regular. The retention duration can be changed at any time.
  1. Click Save and then Continue to confirm your settings.
700

Umbrella activates its ability to export to an AWS S3 account. When activation is complete, the Amazon S3 Summary page appears.

700 700
  1. Copy credentials from this page and store them in a safe place. This is the only time that the Access and Secret keys are made available to you. These keys are required to access your S3 bucket and download logs. If you lose these keys they must be regenerated.
  2. Once keys are copied and safe, check Got it and then click Continue.
    Note: Continue is unavailable until you check Got it.
973

Download Files From the S3 Bucket Locally

👍

When logging to a Cisco-managed S3 bucket is enabled, the download of files from that bucket must be configured so each log file is downloaded only once. Cisco reserves the right to suspend the downloading of logs from a Cisco-managed S3 bucket (through the rotation of keys or other methods) if log files are downloaded multiple times instead of once.

To download files from a Cisco-managed S3 bucket to your local directory, enter a command like the following:
aws s3 sync s3://DATAPATH /path/to/local/directory/

Detailed sample command:
aws s3 sync s3://cisco-managed-us-west-1/2069997_6ff2802af17337def701c2e7816cf14913zf848a /opt/splunk/etc/apps/TA-cisco_umbrella/data/
Note: The AWS command-line interface must be installed.

To run the command in test mode (without syncing files), use the --dryrun flag.

Note: When deleting downloaded files from the local directory, be sure to delete only files that are older than the Retention Duration value configured in the Umbrella dashboard. Otherwise, the next sync command will download the deleted files again.


Set up an Amazon S3 Bucket < Enable Logging to a Cisco-managed S3 Bucket > Stop Logging