Configure Sysdig Captures

Create a Capture File From an Alert

While configuring your alert in the Act section toggle on the Activate Sysdig Capture

ParameterDescription
StorageThe storage location for the capture files. The default storage location is the Sysdig Cloud Amazon S3 bucket. To configure a custom S3 storage bucket, refer to Configure AWS Capture File Storage.
File NameThe name of the capture file. The default name includes the date and time stamp the capture was created.
Time frameThe period of time captured. The default time is 15 seconds; the maximum capture time available is 24 hours. The capture file size limit is 100MB. The capture time starts from the time the alert threshold was breached (it does not capture syscalls from before the alert was triggered)
Note: Sysdig recommends using the default time to ensure captures are small and manageable.
FilterRestricts the amount of trace information collected. For more information, including examples of available filters, refer to the Sysdig Github page.

Create a Capture File Manually

To create a capture file:

  1. From the Explore module, select a host or container.

  2. Click the Key Page Action drop-down menu, and select Sysdig Capture.

    The Sysdig Capture pop-up window will open.

  3. Define the following parameters, and click the Start Capture button:

ParameterDescription
StorageThe storage location for the capture files. The default storage location is the Sysdig Cloud Amazon S3 bucket. To configure a custom S3 storage bucket, refer to Configure AWS Capture File Storage.
Capture path and nameThe name of the capture file. The default name includes the date and time stamp the capture was created.
Time frameThe period of time captured. The default time is 15 seconds; the maximum capture time available is 24 hours. The capture file size limit is 100MB.
Note: Sysdig recommends using the default time to ensure captures are small and manageable.
FilterRestricts the amount of trace information collected. For more information, including examples of available filters, refer to the Sysdig Github page.

The Sysdig agent will be signaled to start a capture, and send back the resulting trace file. The file will then be displayed in the Captures module.

Download a Capture File

To download a capture file:

  1. From the Captures module, navigate to the target capture file.

  2. Select the target capture file.

  3. Click the Download button. A capture file will be automatically downloaded to your local machine.

Delete Capture Files

To delete a single capture file:

  1. From the Captures module, select the capture file to be deleted.

  2. Click the Delete button at the bottom of the Captures module:

  3. On the Keep File prompt, click the Delete button to confirm, or the Keep File button to cancel.

To delete all capture files:

  1. From the Captures module, click the Delete All button:

  2. Click the Yes, Delete Captures button to confirm, or the Cancel button.