Agent-Side Filtering for DogStatsD Custom Metrics

Esta traducción no está actualizada. Para consultar la última versión en inglés, haz clic aquí

El filtrado del lado del Agent para las métricas personalizadas de DogStatsD está en vista previa.

Información general

El filtrado del lado del Agent te permite filtrar las métricas personalizadas no utilizadas o no deseadas de DogStatsD directamente en el Datadog Agent, antes de enviarlas a Datadog. Esto puede reducir significativamente el volumen de métricas personalizadas indexadas e 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 proporciona a los equipos una visibilidad y un control totales. Puedes crear, actualizar y gestionar las políticas de filtrado en Datadog, agilizando la gobernanza de las métricas, al tiempo que mantienes la transparencia.

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

Requisitos previos

API Key properties with Remote Configuration capability Enable button.

Crear una política de filtrado de métricas

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

Las políticas de filtrado de métricas se aplican a todos los Agents v7.67.0+ con Remote Configuration activada. Las versiones anteriores del Agent, o Agents con Remote Configuration desactivada, no aplican políticas de filtrado.

Las actualizaciones de las políticas se despliegan en Agents en 1-2 minutos.

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

  1. Haz clic en + Create Policy (+ Crear política).
  2. Haz clic en Filter metrics (Filtrar métricas).
  3. Brinda una descripción para la nueva política.
  4. Selecciona las métricas a filtrar en el desplegable Metrics to Filter (Métricas a filtrar), o haz clic en Upload CSV (Cargar CSV).
    • Si eliges cargar un CSV, selecciona el archivo y haz clic en Open (Abrir). Puedes utilizar varios CSV para crear la política.
  5. Cuando estés satisfecho con la lista de métricas a filtrar, haz clic en Save and Filter (Guardar y filtrar).

De la página Resumen de métricas

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

    1. Introduce una consulta de métrica en la barra de búsqueda.
    2. Haz clic en el botón de los tres puntos verticales situado a la derecha de la pantalla.
    3. Haz clic en Filter metrics (Filtrar métricas).
    4. En el menú desplegable Choose policy (Elegir política), haz clic en New Policy (Nueva política). Introduce una descripción para la política.
    5. Revisa las Metrics to Filter (Métricas a filtrar). Haz clic en X a la derecha de cualquier fila para eliminar una métrica de la lista, o haz clic en + Include More Metrics para añadir métricas a la lista.
    6. Haz clic en Save and Filter (Guardar y filtrar).
    1. Haz clic en el botón de los tres puntos verticales situado a la derecha de la pantalla.
    2. Haz clic en Filter metrics (Filtrar métricas).
    3. En el menú desplegable Choose policy (Elegir política), haz clic en New Policy (Nueva política). Introduce una descripción para la política.
    4. Introduce una consulta de métricas en el campo Metrics to Filter (Métricas a filtrar), o selecciona métricas individualmente en el desplegable. Haz clic en X a la derecha de cualquier fila para eliminar una métrica de la lista.
    5. Haz clic en Save and Filter (Guardar y filtrar).
    1. Haz clic en el botón de los tres puntos verticales situado a la derecha de la pantalla.
    2. Haz clic en Filter metrics (Filtrar métricas).
    3. En el menú desplegable Choose policy (Elegir política), haz clic en New Policy (Nueva política). Introduce una descripción para la política.
    4. Haz clic en Upload CSV (Cargar CSV) a la derecha del campo Metrics to Filter (Métricas a filtrar).
    5. Selecciona el archivo CSV y haz clic en Open (Abrir).
    6. Revisa las métricas de la lista. Haz clic en X a la derecha de cualquier fila para eliminar una métrica de la lista. Si es necesario, carga los archivos CSV adicionales o añade métricas a través del campo Metrics to filter (Métricas a filtrar).
    7. Haz clic en Save and Filter (Guardar y filtrar).

    Editar una política de filtrado de métricas

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

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

    1. Haz clic en la política que desees editar.
    2. Haz clic en Edit (Editar).
    3. Selecciona las métricas a filtrar en el desplegable Metrics to Filter (Métricas a filtrar), o haz clic en Upload CSV (Cargar CSV).
      • Si elige cargar un CSV, seleccione el archivo y haga clic en Abrir.
    4. Haz clic en Save and Filter (Guardar y filtrar).

    De la página Resumen de métricas

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

      1. Introduce una consulta de métrica en la barra de búsqueda.
      2. Haz clic en el botón de los tres puntos verticales situado a la derecha de la pantalla.
      3. Haz clic en Filter metrics (Filtrar métricas).
      4. En el menú desplegable Choose policy (Elegir política), selecciona la política que deseas editar.
      5. Revisa las Metrics to Filter (Métricas a filtrar) y las listas Existing metrics in policy (Métricas existentes en la política). Haz clic en X a la derecha de cualquier fila para eliminar una métrica de la lista, o haz clic en + Include More Metrics para añadir métricas a la lista.
      6. Haz clic en Save and Filter (Guardar y filtrar).
      1. Haz clic en el botón de los tres puntos verticales situado a la derecha de la pantalla.
      2. Haz clic en Filter metrics (Filtrar métricas).
      3. En el menú desplegable Choose policy (Elegir política), selecciona la política que deseas editar.
      4. Selecciona las métricas individualmente en el desplegable Metrics to Filter (Métricas a filtrar). Haz clic en X a la derecha de cualquier fila para eliminar una métrica de la lista.
      5. Haz clic en Save and Filter (Guardar y filtrar).
      1. Haz clic en el botón de los tres puntos verticales situado a la derecha de la pantalla.
      2. Haz clic en Filter metrics (Filtrar métricas).
      3. En el menú desplegable Choose policy (Elegir política), selecciona la política que deseas editar.
      4. Haz clic en Upload CSV (Cargar CSV) a la derecha del campo Metrics to Filter (Métricas a filtrar).
      5. Selecciona el archivo CSV y haz clic en Open (Abrir).
      6. Revisa las Metrics to Filter (Métricas a filtrar) y las listas Existing metrics in policy (Métricas existentes en la política). Haz clic en X a la derecha de cualquier fila para eliminar una métrica de la lista, o haz clic en + Include More Metrics para añadir métricas a la lista.
      7. Haz clic en Save and Filter (Guardar y filtrar).

      Ver todas las políticas y métricas filtradas

      Puedes ver todas tus políticas y métricas filtradas desde la página de Configuración de métricas.

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

      El botón de configuración de la página de resumen de métricas

      Haz clic en Métricas en la barra de navegación y ve directamente a la configuración:

      La opción de configuración del panel de Métricas expandido en Datadog

      Ver todas las políticas

      Selecciona la pestaña Polocies (Políticas) de la barra lateral para ver una lista de todas tus políticas. Si no ves la barra lateral, haz clic en el botón Show Sidebar (Mostrar barra lateral) .

      Haz clic en cualquier política de filtrado de métricas para abrir su vista detallada para editarla o eliminarla.

      Ver todas las métricas filtradas

      Selecciona la pestaña Filtered Metrics (Métricas filtradas) de la barra lateral para ver una lista de todas tus métricas filtradas. Si no ves la barra lateral, haz clic en el botón Show Sidebar (Mostrar barra lateral) .

      Haz clic en las políticas adjuntas de una métrica filtrada en la columna ATTACHED POLICIES (POLÍTICAS ADJUNTAS) para editarlas o eliminarlas.

      Eliminar políticas

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

      1. Haz clic en la política de filtrado de métricas que desees eliminar.
      2. Selecciona Delete (Borrar) en la esquina superior derecha de la página.
      El botón Eliminar política en una vista detallada de la política de filtrado de métricas

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

      Estos endpoints están sujetos a cambios mientras el filtrado del lado del Agent para las métricas personalizadas de DogStatsD se encuentra en fase de vista previa.

      Estos endpoints requieren una clave de API de Datadog y una clave de aplicación válidas. Consulta Primeros pasos en la Referencia de la API para obtener más información.

      Crear una política de métricas filtradas

      La URL base para tu sitio de Datadog seleccionado es:

      Sustituye <BASE_URL> en el ejemplo siguiente por la URL base.

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

      Ejemplo de cuerpo

      {
  "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 tu sitio de Datadog seleccionado es:

      Sustituye <BASE_URL> en el ejemplo siguiente por la URL base.

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

      Ejemplo de cuerpo

      {
  "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 (sustitución completa)

      La URL base para tu sitio de Datadog seleccionado es:

      Sustituye <BASE_URL> en el ejemplo siguiente por la URL base.

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

      Ejemplo de cuerpo

      {
  "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 tu sitio de Datadog seleccionado es:

      Sustituye <BASE_URL> en el ejemplo siguiente por 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 tu sitio de Datadog seleccionado es:

      Sustituye <BASE_URL> en el ejemplo siguiente por la URL base.

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

      Ejemplo de cuerpo de respuesta

      {
  "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
  }
}

      Lista de políticas métricas filtradas

      La URL base para tu sitio de Datadog seleccionado es:

      Sustituye <BASE_URL> en el ejemplo siguiente por la URL base.

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

      Ejemplo de cuerpo de respuesta

      {
    "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 vista previa

      Esta versión preliminar inicial incluye las siguientes limitaciones:

      • Se puede filtrar un máximo de 10.000 nombres de métricas.
      • El impacto en el uso de recursos en el Agent se limita a un máximo de 10 MB de memoria (RSS), y no aumenta el uso de la CPU.
      • Solo se admiten las métricas de DogStatsD.

      Referencias adicionales

      Más enlaces, artículos y documentación útiles:

      Learn more about Custom Metrics more more Custom Metrics Billing more more Metrics without LimitsTM more more Metrics Volume Management more more Best practices for end-to-end custom metrics governanceBLOG more more