Configure Default Integrations

Prerequisites

• PromScrape version 2. See Migrating from Promscrape V1 to V2.

Default Integrations

Sysdig provides default integrations for applications in the Integrations Library. For example: Application integrations, cloud integrations, and infrastructure integrations.

Default integrations collect metrics from a source and send them to Sysdig Monitor. The metrics Sysdig collects by default have been chosen for their value in building Dashboards and creating Alerts. To collect additional metrics or remove metrics from collection, see Customize a Default Job.

To limit metric collection to specific clusters, see Exlude Clusters from Collecton.

Supported Monitoring Integrations

Integrations can be:

• Enabled by default: The integration will start reporting metrics as soon as the Sysdig Agent detects the application. You do not need to manually enable this type of integration. See Enable and Disable Integrations.
• Out of the box: The integration requires no exporter or extra configuration to retrieve metrics from the application. See Configure an Integration.

Sysdig supports the following default integrations:

Enable and Disable Integrations

Some integrations are not enabled by default due to the potential high cardinality of their metrics. To enable or disable integrations:

Configure an Integration

Some default integrations require configuration, such as installing an exporter, to collect metrics. These workloads will appear under the Requires Configuration list. To configure:

1. Click on one of the workloads listed under Requires Configuration.

   A wizard appears.

   

2. Ensure the instance has been correctly identified. If you suspect Sysdig has misidentified the instance, click Configure another integration and choose the correct integration from the integration library. If your integration is not available, you may need to create a custom configuration, see Custom Integrations

3. If it is correct, click Start Configuration.

4. The wizard provides instructions, including code snippets and configuration details, for each type of default integration. Follow all the steps provided by the wizard, and once you’re finished, click Close.

Some configurations involve setting up an exporter. To customize an exporter, see Add Sysdig Annotations in Exporters.

Customize a Default Job

The default jobs offered by Sysdig for integrations are optimized to scrape the metrics for building dashboards and alerts in Sysdig Monitor. However, you may wish to manually configure which metrics are collected.

To overwrite a default job:

1. Locate the prometheus.yaml file in the sysdig-agent ConfigMap in the sysdig-agent namespace.

2. Consult the Integrations Library for the complete list of default integrations. Find the default agent job in the Agent Configuration section. See, for example, Cassandra Agent Configuration.

3. Add a new job to the prometheus.yaml file with the same name as the default job you want to replace. For example, if you want to create a new job for the Cassandra integration, create a new job with the name cassandra-default.

   Jobs defined by the user have precedence over the default ones.

Annotate Exporters to Collect Metrics

Sysdig provides a set of Helm charts that helps you configure the exporters for the integrations. Helm charts are publicly available in the Sysdig Helm repository.

If exporters are already installed in your cluster, you can use the standard Prometheus annotations and the Sysdig agent will automatically scrape them.

To collect metrics from an exporter, add this annotation:

spec:
  template:
    metadata:
      annotations:
        prometheus.io/path: /metrics
        prometheus.io/port: '9100'
        prometheus.io/scrape: 'true'