Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Conexión a un origen de datos de Datadog
El origen de datos de Datadog le permite visualizar datos del servicio de supervisión de Datadog en Amazon Managed Grafana.
**nota**
Este origen de datos es solo para Grafana Enterprise. Para obtener más información, consulte [Administración del acceso a los complementos empresariales](upgrade-to-enterprise-plugins.md).
Además, en los espacios de trabajo compatibles con la versión 9 o posterior, es posible que se deba instalar el complemento adecuado para este origen de datos. Para obtener más información, consulte [Ampliación de su espacio de trabajo con complementos](grafana-plugins.md).
## De uso
### Almacenamiento en caché
En el caso de paneles de gran tamaño, en los que se hacen muchas consultas, es posible limitar la frecuencia mediante la API de Datadog (alcanzar el número máximo de llamadas a la API por hora que permite la API de Datadog). La característica de almacenamiento en caché almacena en caché consultas únicas durante 60 segundos. Este intervalo se puede cambiar para que sea más largo o más corto en la página de configuración.
### Editor de consultas
Es fácil: seleccione la agregación y la métrica. Si desea filtrar el resultado, seleccione una o más etiquetas.
El origen de datos de Datadog admite todas las funciones avanzadas que admite el editor de consultas de Datadog. Selecciónelo en la lista desplegable y organícelo eligiendo un nombre de función.
**Posibilidades de uso del campo Alias por**:
+ Introduzca el alias en el campo “Alias por”.
+ Utilice variables de ámbito específico:
+ `$__metric` = se reemplaza por el nombre de la métrica.
+ `$__display_name` = se reemplaza por el nombre de la métrica.
+ `$__expression` = se reemplaza por la expresión de una métrica completa.
+ `$__aggr` = se reemplaza por una función de agregación de una métrica (por ejemplo, avg, max, min, sum).
+ `$__scope` = se reemplaza por el ámbito de una métrica (por ejemplo, region, site, env, host)
+ Use expresiones regulares:
+ Introduzca su expresión regular en el campo RegExp «Alias» en `/you regexp here/flags` formato.
+ Si el campo «Alias por» está vacío, RegExp los resultados se unirán utilizando. Ejemplo con la expresión métrica =`avg:system.load.5{*}`: Entrada de campo «Alias por»: Entrada de campo «" "Alias» RegExp: `avg:(.+)\.(\d)` Resultado: `system.load, 5`
+ Utilice variables `$` en el campo “Alias por”. Ejemplo con expresión métrica =`avg:system.load.5{*}`: Entrada de campo «Alias por»: entrada de campo `$1: $2 seconds` RegExp «Alias»: `avg:(.+)\.(\d)` Resultado: `system.load: 5 seconds`
+ Utilice `$0` para obtener la expresión completa. Ejemplo con expresión métrica =`datadog.dogstatsd.packet.count{*}`: Entrada de campo «Alias por»: entrada de campo `Expression: $0` RegExp «Alias»: `DOGstatsd\.(.*)\.(.*){\*}/i` Resultado: `Expression: datadog.dogstatsd.packet.count{*}`
Nota: Aparecerá un error al utilizar un número de grupo inexistente.
#### Aritmética de métricas
Para usar la aritmética de métricas, defina *Tipo de consulta* en *Aritmética*. Vincule a la métrica que desee con el signo `#`. Por ejemplo, `#A * 2` duplicará el resultado de la consulta `A`. La aritmética entre dos métricas funciona de la misma manera: agregue consultas con los resultados que quiera usar para el cálculo y, a continuación, vincule estas métricas en la tercera consulta, por ejemplo `#A / #B`.
### Anotaciones
Una anotación es un evento que se superpone sobre los gráficos; un ejemplo de un evento es una implementación o una interrupción. Con este origen de datos, puede obtener eventos de Datadog y superponerlos en gráficos en Amazon Managed Grafana. Los eventos de anotaciones se pueden filtrar por origen, etiqueta o prioridad.
### Plantillas
Existen varias opciones para obtener los valores de la variable de la plantilla: métricas y etiquetas. Para obtener la lista de métricas disponibles, especifique `*` en el campo *Consulta*.
Para devolver todas las etiquetas, utilice el valor: `tag` o `scope`.
Para devolver las etiquetas de un grupo de etiquetas especificado, utilice uno de los siguientes valores de categoría predeterminados:
+ `host`
+ `device`
+ `env`
+ `region`
+ `site`
+ `status`
+ `version`
Para grupos de etiquetas personalizados, simplemente ingrese el nombre del grupo de etiquetas. Por ejemplo, si el nombre de su grupo de etiquetas personalizado es `subscription_name`, ingréselo en el campo *Consulta*.
Filtre los resultados mediante el campo *Expresión regular*. Cuando se utilizan etiquetas, se admiten variables con varios valores; varios valores de etiquetas seleccionados se convertirán en una lista de etiquetas separadas por comas.
#### Filtros ad hoc
Hay un nuevo tipo especial de variable de plantilla en Grafana llamado *Filtros ad hoc*. Esta variable se aplicará a *todas* las consultas de Datadog en un panel. Esto permite usarla como un filtro rápido. Una variable ad hoc para Datadog busca todos los pares de clave-valor de las etiquetas (por ejemplo, `region:east, region:west`) y los utiliza como etiquetas de consulta. Para crear esta variable, seleccione el tipo *Filtros ad hoc* y elija su origen de datos de Datadog. Puede establecer cualquier nombre para esta variable.