Métricas derivadas

Descripción general

Las métricas derivadas le permiten guardar cualquier consulta de métricas como una nueva métrica, para que pueda simplificar y optimizar cómo trabaja con métricas en Datadog. En lugar de crear repetidamente consultas complejas en tableros, seguimientos, SLOs y cuadernos, puede crear una métrica derivada una vez y reutilizarla en todos sus activos. Utilice métricas derivadas para:

  • Simplificar las consultas: Defina una consulta una vez, guárdela como una métrica derivada y reutilícela en todas partes.
  • Reducir errores y aumentar la consistencia: Mantenga las fórmulas de forma centralizada para evitar errores y garantizar la uniformidad entre los equipos.
  • Acelerar los flujos de trabajo: No se necesitan cambios de código ni nuevos envíos de métricas; cree nuevas métricas directamente a partir de las métricas existentes en Datadog.
  • Obtenga control y auditabilidad: Gestione y mejore las fórmulas derivadas en un solo lugar.

Nota: Las métricas derivadas no se facturan como Custom Metrics, ya que se calculan dinámicamente al momento de la consulta y no se almacenan ni indexan.

Crear una métrica derivada

Para crear una métrica derivada, navegue a Metrics > Generate Metrics y haga clic en + New Metric.

La pestaña generate metrics en Datadog
  1. Asigne a su métrica derivada un nombre que no comience con datadog.estimated_usage. Utilice el formato descrito en naming Custom Metrics.

  2. Defina cualquier consulta de métricas subyacente y, opcionalmente, utilice el cuadro de fórmulas para definir las operaciones matemáticas que se realizarán sobre los valores de las métricas.

    Por ejemplo, para monitorear la estabilidad general de los conectores de Kafka, podría crear consultas individuales a y b utilizando las métricas kafka.connect.connector.status.running y kafka.connect.connector.status.failed. Luego, en el cuadro de fórmulas, ingrese la fórmula (a / (a + b)) * 100.

    Para obtener más información sobre cómo definir consultas de métricas, consulte consulta de métricas.

Una consulta de métricas de Datadog para generar una métrica derivada
  1. Haga clic en Create Metric.

Actualizar una métrica derivada

Para actualizar una métrica derivada, coloque el cursor sobre la métrica y haga clic en el icono Edit que aparece a la derecha.

**Nota **: No puede cambiar el nombre de una métrica existente. Cree una métrica nueva en su lugar.

Eliminar una métrica derivada

Para eliminar una métrica derivada, coloque el cursor sobre la métrica derivada y haga clic en el icono Delete que aparece a la derecha.

Administre métricas derivadas con Terraform

Utilice el datadog_derived_metricrecurso para crear, actualizar y eliminar definiciones de métricas derivadas con Terraform.

Antes de comenzar, configure el proveedor de Datadog para Terraform. Su clave de aplicación necesita los permisos Metrics Read (metrics_read) y Manage Tags for Metrics (metric_tags_write). Consulte Claves de API y claves de aplicación para obtener más detalles.

Por ejemplo, agregue este recurso a su configuración de Terraform para combinar dos métricas de CPU:

resource "datadog_derived_metric" "cpu_total" {
  name = "custom.cpu.total"
  definition = {
    formula = "a + b"
    queries = [
      {
        name        = "a"
        data_source = "metrics"
        query       = "avg:system.cpu.user{*}"
      },
      {
        name        = "b"
        data_source = "metrics"
        query       = "avg:system.cpu.system{*}"
      },
    ]
  }
}

Ejecute terraform plan para revisar los cambios y luego ejecute terraform apply para crear la métrica derivada.

Los cambios en definition.formula o definition.queries actualizan la definición existente. Cambiar name reemplaza la métrica derivada.

Para administrar una métrica derivada existente, agregue su configuración de recurso e impórtela por nombre:

terraform import datadog_derived_metric.cpu_total "custom.cpu.total"

Después de importar, ejecute terraform plan y terraform apply para adoptar el nombre y la definición configurados. La primera ejecución de apply actualiza la métrica existente. Los cambios posteriores a name la reemplazan.

Lecturas adicionales

Documentación, enlaces y artículos útiles adicionales: