Skip to main content

Integrate with Datadog

Datadog is a cloud monitoring and analytics platform that provides real-time insights into application performance, infrastructure, and log management. By integrating Zilliz Cloud with Datadog, you can send metric data about your Zilliz Cloud clusters to your Datadog dashboards.

📘Notes

This feature is available only to Dedicated clusters in an Enterprise project.

Before you start

  • To integrate with Datadog, you must have Organization Owner or Project Admin access to the project. If you do not have necessary permissions, contact your Zilliz Cloud administrator.

  • You must have a Datadog account and a Datadog API key. For information on how to access your API key, refer to API and Application Keys.

Procedure

integrate-with-datadog-1

1

Log in to the Zilliz Cloud console.

2

In the left-side navigation pane of the project page, click Integrations.

3

Locate the Datadog section and click + Configuration next to it.

4

In the dialog box that appears, link Datadog to your project and assign clusters to collect metric data.

  1. In the Configure Datadog Integration step, configure Datadog settings.

    1. In Configuration Name, Enter a name for the integration (e.g., DG_configuration).

    2. In Datadog API Key, enter your Datadog API key.

    3. In Datadog Site, select your Datadog site. Zilliz Cloud supports the following Datadog sites:

      SiteSite URLSite ParameterLocation
      US1https://app.datadoghq.comdatadoghq.comUS
      US3https://us3.datadoghq.comus3.datadoghq.comUS
      US5https://us5.datadoghq.comus5.datadoghq.comUS
      EU1https://app.datadoghq.eudatadoghq.euEU (Germany)
      AP1https://ap1.datadoghq.comap1.datadoghq.comJapan

      For details on Datadog sites, refer to Access Datadog Sites.

    4. Click Test Integration to verify the connection between Zilliz Cloud and Datadog. If the test is successful, proceed to assign clusters.

  2. In the Assign Configuration to Zilliz Cloud Cluster(s) step, select one or more clusters from which metric data will be pushed to Datadog.

    📘Notes

    Only clusters of the Dedicated-Enterprise plan tier can be selected.

  3. Click Create.

Monitor integration progress

After setup, return to the Integrations page and verify that your Datadog integration is listed with the provided configuration details. If the status changes to Active, the integration is successful. Zilliz Cloud pushes data to Datadog at a minute-level frequency, ensuring near real-time updates.

By clicking the external link icon next to the integration, you can open the associated Datadog dashboard to view cluster metrics that are pushed from the selected Zilliz Cloud clusters.

integrate-with-datadog-2

Manage integrations

To manage your Datadog integration, use the Actions column:

  • Edit: Update the monitoring cluster or modify integration settings as needed.

  • Remove: Delete the integration if it is no longer required.

integrate-with-datadog-3

Performance metrics available to Datadog

Datadog tracks the following metric data for your Zilliz Cloud cluster. The metric names in parentheses are the names used in the Datadog UI.

Resource

Metric NameMetric TypeDescription
CU Computation
(zilliz.cluster.cu.computation.current)
GaugeA measure of the used capacity relative to the total capacity of the CU. Range from 0 to 1.
CU Capacity
(zilliz.cluster.cu.capacity.current)
GaugeA measure of the utilized computational power relative to the total computational capacity of the CU. Range from 0 to 1.
Storage
(zilliz.cluster.storage.bytes.current)
GaugeThe total amount of persistent storage consumed by data and indexes.

Performance

Metric NameMetric TypeDescription
Cluster Write Performance Capacity
(zilliz.cluster.write.performance.capacity.current)
GaugeA measure of the current rate of write operation relative to the write rate limit. Range from 0 to 1.
Slow Query Count
(zilliz.request.slow.queries.total)
CountThe total number of slow query requests.
QPS, Request Failure Rate, Number of Flush Operations
(zilliz.requests.total)
CountThe total number of requests processed.
VPS
(zilliz.request.vectors.total)
CountThe total number of vectors manipulated across all requests.
Latency
(zilliz.request.latency.milliseconds.average, zilliz.request.latency.milliseconds.p99)
GaugeThe average/P99 latency of requests processed.

Data

Metric NameMetric TypeDescription
Entity Count
(zilliz.entities.current)
GaugeThe number of entities.
Loaded Entities
(zilliz.loaded.entities.current)
GaugeThe number of loaded entities.
Collection Count
(zilliz.collections.current)
GaugeThe number of collections.
Number of Unloaded Collections
(zilliz.unloaded.collections.current)
GaugeThe number of unloaded collections.

Tags available to Datadog

Datadog sends the following tags on certain metrics to help you better understand, organize, and identify resources.

Tag NameDescription
org_idThe ID of the Zilliz Cloud organization associated with the metric.
project_idThe ID of the Zilliz Cloud project associated with the metric.
cluster_idThe ID of the Zilliz Cloud cluster associated with the metric.
request_typeThe type of operation that is being monitored. Possible values: insert, upsert, delete, bulk_insert, flush, search, query
statusThe outcome of the operation. Possible values: success, fail
Ctrl I