Filtrado del Agent para Custom Metrics

Join the Preview!

El filtrado del Agent para Custom Metrics está en versión preliminar. Si le interesa esta función, complete este formulario.

Request Access

Descripción general

El filtrado del Agent le permite filtrar Custom Metrics no utilizadas o no deseadas (tanto de DogStatsD como de integraciones del Agent) directamente en el Datadog Agent, antes de enviarlas a Datadog. Esto puede reducir significativamente el volumen de Custom Metrics tanto indexadas como ingeridas.

El filtrado se realiza a nivel del Agent, pero se gestiona de forma centralizada a través de la interfaz de usuario de Datadog, lo que brinda a los equipos visibilidad y control totales. Puede crear, actualizar y gestionar políticas de filtrado en Datadog, lo que agiliza la gobernanza de métricas mientras mantiene la transparencia.

La creación y actualización de políticas de filtrado requiere el permiso de RBAC metric_tags_write. Todos los usuarios pueden visualizar las políticas de filtrado.

Requisitos previos

  • Actualice a Datadog Agent v7.67.0 o superior.
    • Se recomienda usar la v7.70.0 o superior para filtrar métricas de DogStatsD.
    • Se requiere usar la v7.74.0 o superior para las métricas de integraciones del Agent.
  • Con los permisos org_management, habilite Remote Configuration para su organización.
  • Con los permisos api_keys_write, habilite capacidad de Remote Configuration en las claves de API que utilizan sus Agents. Después de habilitar Remote Configuration en una clave de API, reinicie sus Agents para que el cambio surta efecto.
Botón Habilitar propiedades de clave de API con capacidad de Remote Configuration.

Crear una política de filtrado de métricas

Puede crear una política de filtrado de métricas desde la página Configuración de métricas o la página Metrics Summary.

Las políticas de filtrado de métricas se aplican a todos los Agents v7.67.0+ (v7.74.0+ para métricas de Agent Integration) con Remote Configuration habilitado. Las versiones de Agent más antiguas, o los Agents con Remote Configuration deshabilitado, no aplican políticas de filtrado.

Las actualizaciones de políticas se implementan en los Agents en 1-2 minutos.

Desde la página Configuración de métricas

  1. Haga clic en + Create Policy.
  2. Haga clic en Filter metrics.
  3. Proporcione una descripción para la nueva política.
  4. Seleccione las métricas para filtrar desde el menú desplegable Metrics to Filter, o haga clic en Upload CSV.
    • Si elige cargar un CSV, seleccione el archivo y haga clic en Open. Puede usar varios archivos CSV para crear la política.
  5. Cuando esté satisfecho con la lista de métricas para filtrar, haga clic en Save and Filter.

Desde la página Metrics Summary

Cree una política de filtrado de métricas desde la página Metrics Summary usando cualquiera de los siguientes métodos:

    1. Ingrese una consulta de métricas en la barra de búsqueda.
    2. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla.
    3. Haga clic en Filter metrics.
    4. En el menú desplegable Choose policy, haga clic en New Policy. Proporcione una descripción para la política.
    5. Revise Metrics to Filter. Haga clic en X en el lado derecho de cualquier fila para eliminar una métrica de la lista, o haga clic en + Include More Metrics para agregar métricas a la lista.
    6. Haga clic en Save and Filter.
    1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla.
    2. Haga clic en Filter metrics.
    3. En el menú desplegable Choose policy, haga clic en New Policy. Proporcione una descripción para la política.
    4. Ingrese una consulta de métrica en el campo Metrics to Filter, o seleccione métricas individualmente desde el menú desplegable. Haga clic en X en el lado derecho de cualquier fila para eliminar una métrica de la lista.
    5. Haga clic en Save and Filter.
    1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla.
    2. Haga clic en Filter metrics.
    3. En el menú desplegable Choose policy, haga clic en New Policy. Proporcione una descripción para la política.
    4. Haga clic en Upload CSV a la derecha del campo Metrics to Filter.
    5. Seleccione el archivo CSV y haga clic en Open.
    6. Revise las métricas enumeradas. Haga clic en X en el lado derecho de cualquier fila para eliminar una métrica de la lista. Si es necesario, cargue archivos CSV adicionales o agregue métricas a través del campo Metrics to Filter.
    7. Haga clic en Save and Filter.

    Edite una política de filtrado de métricas

    Puede editar una política de filtrado de métricas desde la página de Configuración de métricas o la página de Metrics Summary.

    Desde la página Configuración de métricas

    1. Haga clic en la política para editarla.
    2. Haga clic en Edit.
    3. Seleccione las métricas para filtrar desde el menú desplegable Metrics to Filter, o haga clic en Upload CSV.
      • Si elige cargar un CSV, seleccione el archivo y haga clic en Open.
    4. Haga clic en Save and Filter.

    Desde la página de Metrics Summary

    Edite una política de filtrado de métricas desde la página de Metrics Summary utilizando cualquiera de los siguientes métodos:

      1. Ingrese una consulta de métricas en la barra de búsqueda.
      2. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla.
      3. Haga clic en Filter metrics.
      4. En el menú desplegable Choose policy, seleccione la política que desea editar.
      5. Revise las listas Metrics to Filter y Existing metrics in policy. Haga clic en X en el lado derecho de cualquier fila para eliminar una métrica de la lista, o haga clic en + Include More Metrics para agregar métricas a la lista.
      6. Haga clic en Save and Filter.
      1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla.
      2. Haga clic en Filter metrics.
      3. En el menú desplegable Choose policy, seleccione la política que desea editar.
      4. Seleccione las métricas individualmente desde el menú desplegable Metrics to Filter. Haga clic en X en el lado derecho de cualquier fila para eliminar una métrica de la lista.
      5. Haga clic en Save and Filter.
      1. Haga clic en el botón de tres puntos verticales en el lado derecho de la pantalla.
      2. Haga clic en Filter metrics.
      3. En el menú desplegable Choose policy, seleccione la política que desea editar.
      4. Haga clic en Upload CSV a la derecha del campo Metrics to Filter.
      5. Seleccione el archivo CSV y haga clic en Open.
      6. Revise las listas Metrics to Filter y Existing metrics in policy. Haga clic en X en el lado derecho de cualquier fila para eliminar una métrica de la lista, o haga clic en + Include More Metrics para agregar métricas a la lista.
      7. Haga clic en Save and Filter.

      Visualizar todas las políticas y métricas filtradas

      Puede visualizar todas sus políticas y métricas filtradas desde la página de Configuración de métricas.

      Haga clic en el botón de configuración:

      El botón de configuración en la página de Metrics Summary

      Haga clic en Metrics en la barra de navegación y vaya directamente a la configuración:

      La opción de configuración del panel de Metrics expandido en Datadog

      Visualizar todas las políticas

      Seleccione la pestaña Policies de la barra lateral para ver una lista de todas sus políticas. Si no ve la barra lateral, haga clic en el botón Show Sidebar .

      Haga clic en cualquier política de filtrado de métricas para abrir y visualizar su detalle, para editarla o eliminarla.

      Visualizar todas las métricas filtradas

      Seleccione la pestaña Filtered Metrics de la barra lateral para ver una lista de todas sus métricas filtradas. Si no ve la barra lateral, haga clic en el botón Show Sidebar .

      Haga clic en las políticas adjuntas de una métrica filtrada en la columna ATTACHED POLICIES para editarlas o eliminarlas.

      Eliminar políticas

      Puede eliminar políticas de filtrado de métricas desde la página de Configuración de métricas.

      1. Haga clic en la política de filtrado de métricas para eliminar.
      2. Seleccione Delete en la esquina superior derecha de la página.
      El botón de eliminar política en una vista de detalles de política de filtrado de métricas

      Administrar políticas de filtrado de métricas a través de la API

      Estos puntos de conexión están sujetos a cambios mientras el filtrado del lado del Agent para métricas personalizadas esté en versión preliminar.

      Estos puntos de conexión requieren una clave de Datadog API y una clave de aplicación válidas. Consulte Introducción en la Referencia de la API para obtener más información.

      Crear una política de métricas filtradas

      La URL base para su sitio de Datadog seleccionado es:

      Sustituya <BASE_URL> en el ejemplo a continuación con la URL base.

      POST <BASE_URL>/api/unstable/remote_config/products/metric_control/filtered_metrics/policies

      Cuerpo del ejemplo

      {
  "data": {
    "type": "filtered_metrics",
    "attributes": {
      "policy_name": "my policy",
      "metric_names": [
        "metric.name.one",
        "metric.name.two"
      ]
    }
  }
}

      Actualizar una política de métricas filtradas (actualización parcial)

      La URL base para su sitio de Datadog seleccionado es:

      Sustituya <BASE_URL> en el ejemplo a continuación con la URL base.

      PATCH <BASE_URL>/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}

      Cuerpo del ejemplo

      {
  "data": {
    "type": "filtered_metrics",
    "attributes": {
      "policy_name": "my policy",
      "metrics_to_add": [
        "metric.name.three",
        "metric.name.four"
      ],
      "metrics_to_remove": [
        "metric.name.five",
        "metric.name.six"
      ]
    }
  }
}

      Actualizar una política de métricas filtradas (reemplazo completo)

      La URL base para su sitio de Datadog seleccionado es:

      Sustituya <BASE_URL> en el ejemplo a continuación con la URL base.

      PUT <BASE_URL>/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}

      Cuerpo del ejemplo

      {
  "data": {
    "type": "filtered_metrics",
    "attributes": {
      "policy_name": "my policy",
      "metric_names": [
        "metric.name.seven",
        "metric.name.eight"
      ]
    }
  }
}

      Eliminar una política

      La URL base para su sitio de Datadog seleccionado es:

      Sustituya <BASE_URL> en el ejemplo a continuación con la URL base.

      DELETE <BASE_URL>/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}

      Obtener una política de métricas filtradas

      La URL base para su sitio de Datadog seleccionado es:

      Sustituya <BASE_URL> en el ejemplo a continuación con la URL base.

      GET <BASE_URL>/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}

      Cuerpo de respuesta de ejemplo

      {
  "data": [
    {
      "type": "filtered_metrics",
      "id": "metric.name.one",
      "attributes": {
        "updated_timestamp": 1745954352
      }
    },
    {
      "type": "filtered_metrics",
      "id": "metric.name.two"
      "attributes": {
        "updated_timestamp": 1745954389
      }
    }
    // ... up to ~10,000 entries
  ],
  "links": {
    "self": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=200&page[limit]=100",
    "next": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=300&page[limit]=100",
    "prev": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=100&page[limit]=100",
    "first": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=0&page[limit]=100",
    "last": "/api/unstable/remote_config/products/metric_control/filtered_metrics/policies/{policy-id}?page[offset]=9900&page[limit]=100"
  },
  "meta": {
    "agent_coverage_percent": 100,
    "agents_with_latest_policy_count": 4,
    "deployment_failure": {
        "failed_agent_count": 0,
        "failure_message": ""
    },
    "deployment_status": "Deployed to all Agents",
    "deployment_strategy": "all",
    "policy_name": "test_policy_1",
    "total": 7,
    "total_agent_count": 4,
    "updated_by": "user@datadoghq.com",
    "updated_timestamp": 1758912365
  }
}

      Listar políticas de métricas filtradas

      La URL base para su sitio de Datadog seleccionado es:

      Sustituya <BASE_URL> en el ejemplo a continuación con la URL base.

      GET <BASE_URL>/api/unstable/remote_config/products/metric_control/filtered_metrics/policies

      Cuerpo de respuesta de ejemplo

      {
    "data": [
        {
            "id": "06b-fab-47e",
            "type": "filtered_metrics",
            "attributes": {
                "count": 85,
                "deployment_status": "Deployed to all Agents",
                "deployment_strategy": "all",
                "policy_name": "policy one",
                "updated_by": "user@datadoghq.com",
                "updated_timestamp": 1758547485,
                "version": 4            
            }
        },
        {
            "id": "07b-201-47e",
            "type": "filtered_metrics",
            "attributes": {
                "count": 8,
                "deployment_status": "Deployed to all Agents",
                "deployment_strategy": "all",
                "policy_name": "policy two",
                "updated_by": "user@datadoghq.com",
                "updated_timestamp": 1758547212,
                "version": 1
            }
        }
    ]
}

      Limitaciones de la versión preliminar

      Esta versión preliminar inicial incluye las siguientes limitaciones:

      • Se puede filtrar un máximo de 10,000 nombres de métricas.
      • El impacto del uso de recursos en el Agent se limita hasta 10MB de memoria (RSS), y no hay aumento en el uso de CPU.
      • Solo se admiten métricas personalizadas recibidas de DogStatsD o de integraciones del Agent.

      Lecturas adicionales

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

      Más información sobre Custom MetricsDOCUMENTACIÓN more more Facturación de Custom MetricsDOCUMENTACIÓN more more Metrics without Limits™DOCUMENTACIÓN more more Gestión del volumen de métricasDOCUMENTACIÓN more more Prácticas recomendadas para la gobernanza integral de Custom MetricsBLOG more more