Configure Custom Integrations

Use custom integrations to collect metrics from applications not found in the Integrations Library. Workloads that require custom integrations are normally found under Unidentified Workloads in the Sysdig Monitoring Integrations page. This page explains how to configure custom integrations in Sysdig Monitor.

View Unidentified Workloads

When Sysdig does not recognize the application from which metrics have come, it categorizes them as “Unidentified workloads.” You can configure these integrations via custom integration steps.

To view unidentified workloads Sysdig has detected in your environments:

  1. Log in to Sysdig Monitor.
  2. Select Integrations > Monitoring Integrations.
  3. Select the Show Unidentified Workloads toggle on the top right of the page.

In rare cases, Sysdig may have a default integration, but the backend did not correctly identify the workload. In this case, you can manually assign the correct Integration. See .

Collect Metrics with Custom Integrations

There are several ways to collect metrics with custom integrations, depending on the location of the workload, and the type of metrics:

Once configured, custom integrations will not be visible from the Monitoring Integrations page. To view those metrics:

  1. Select Explore > Metrics Usage.
  2. Select the All jobs drop down to filter your metrics by job.

The metrics will also be available in modules such as Dashboards and Alerts.

Third Party Integrations

Platform Metrics (IBM)

For Sysdig instances deployed on IBM Cloud Monitoring with Sysdig, an additional form of metrics collection is offered: Platform metrics. Rather than being collected by the Sysdig agent, when enabled, Platform metrics are reported to Sysdig directly by the IBM Cloud infrastructure.

Platform metrics are metrics that are exposed by enabled services across the IBM Cloud platform. These services have made metrics and pre-defined dashboards for their services available by publishing metrics associated with the customer’s space or account. Customers can view these platform metrics alongside the metrics from their applications and other services within IBM Cloud monitoring.

Enable this feature by logging into the IBM Cloud console and selecting Enable for IBM Platform metrics under the Configure your resource section when creating a new IBM Cloud Monitoring with a Sysdig instance. See Enabling a monitoring instance through the UI.

Keda

To integrate Keda for Horizontal Pod Autoscaler (HPA), see Integrate Keda for HPA.

Prometheus Recording Rules

To enable Prometheus Recording Rules for metric aggregation and querying, see Configure Recording Rules.

Topics in This Section
Collect Prometheus Metrics

Sysdig supports collecting, storing, and querying Prometheus native metrics and labels. You can use Sysdig in the same way that you use Prometheus and leverage Prometheus Query Language (PromQL) to create dashboards and alerts.

Enable Prometheus Native Service Discovery

Migrating from Promscrape V1 to V2

Promscrape is the lightweight Prometheus server embedded in the Sysdig agent. An updated version of Promscrape, named Promscrape V2 is available.

Integrate JMX Metrics from Java Virtual Machines

The Sysdig agent retrieves data from your Java virtual machines using the Java Management Extensions (JMX) protocol. The agent is configured to automatically discover active Java Virtual Machines (JVM) and poll them for basic metrics like Heap Memory and Garbage collector as well as application-specific metrics.

Integrate Keda for HPA

Integrate Node.js Application Metrics

To monitor node.js applications, link a library to the Node.js code, which then creates a server in the code to export the StatsD metrics.

Integrate StatsD Metrics

StatsD is an open-source project built by Etsy. Using a StatsD library specific to your application’s language, it allows for the easy generation and transmission of custom application metrics to a collection server.