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 Dynatrace
Fuente de datos para [https://www.dynatrace.com/](https://www.dynatrace.com). Para usar este origen de datos, debe tener una cuenta de Dynatrace.
**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).
**Limitaciones conocidas**
Las variables de plantilla no se pueden seleccionar de forma múltiple. Solo se admite una selección.
Solo APIs se admiten las métricas v2.
## Características
### Características principales
+ Variables de plantilla
+ Nombres de métricas
+ Solo selección única (**sin selección múltiple**)
+ Filtros ad hoc
+ Anotaciones
+ No se admiten actualmente
+ Uso de alias
+ Nombres de métricas
+ Agregación
+ Nombre de visualización
+ Host
+ Description (Descripción)
+ Alertas
+ Compatibilidad completa con las alertas
### Características específicas de Dynatrace
Admite métricas integradas y personalizadas mediante la API de métricas de la versión 2 de Dynatrace. Para obtener más información, consulte la documentación de Dynatrace: [Metrics API v2](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/) y [Metric ingestion](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/).
Según la métrica, la API puede admitir opciones de transformación adicionales.
## Permisos de Dynatrace
Necesitará los siguientes permisos en Dynatrace: permiso para leer métricas con la versión 2 de la API (metrics.read) y permiso para leer entidades con la versión 2 de la API (entities.read).
## Obtención de una clave de API de Dynatrace
Para configurar un token de API, consulte [Dynatrace API - Tokens and authentication](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication/?api-token%3C-%3Epersonal-access-token=api-token)
Establezca los permisos `metrics.read` y `entities.read` de su token de API.
### Configuración
1. Elija **Configuración/Orígenes de datos** en la interfaz de usuario del servidor lógico de Grafana y elija **Agregar origen de datos**.
1. En la página **Agregar origen de datos**, filtre por **Dynatrace** y seleccione el complemento Dynatrace.
1. La configuración de un origen de datos de Dynatrace requiere los siguientes parámetros:
+ `Name`: nombre que desea aplicar al origen de datos de Dynatrace (predeterminado: Dynatrace).
+ `Dynatrace API Type`: tipo de instancia de Dynatrace a la que se está conectando. Es `SaaS` o `Managed Cluster`.
+ `Dynatrace API Token`: este es el token de API que generó en el paso anterior.
Las dos configuraciones siguientes dependen de si es Dynatrace (SaaS) o administrado:
+ En un ejemplo de SaaS de `yfc55578.live.dynatrace.com`, su **ID de entorno** sería `yfc55578`.
+ En el ejemplo administrado de `yd8888.managed-sprint.dynalabs.io/e/abc99984-3af2-55tt-72kl-0672983gc45`, su **ID de entorno** sería `abc99984-3af2-55tt-72kl-0672983gc45` y su **dominio** sería `yd8888.managed-sprint.dynalabs.io`.
1. Una vez establecidos todos los valores de configuración, elija **Guardar y probar** para validar la configuración y guardar los cambios.
### Consulta del origen de datos
Utilice el editor de consultas para consultar las métricas y los problemas de Dynatrace. El tipo de consulta puede ser `metric` o `problem`.
**Tipo de consulta de métrica**
+ `Metric`: seleccione la métrica que desee ver. Para volver a obtener la lista de métricas de Dynatrace, seleccione el botón **Actualizar**.
+ `Aggregations`: seleccione la agregación que desee usar para una métrica específica. Elija el valor de agregación para cambiar el tipo de agregación o elija **\$1** para agregar otra agregación.
+ `Transformations`: puede seleccionar transformaciones en el editor de consultas. A continuación, ingrese una serie de parámetros en la transformación seleccionada. Actualmente, solo se admite la transformación de fusión. Para obtener más información sobre las transformaciones de fusión, consulte [Merge transformation](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation).
+ `Filters`: el origen de datos de Dynatrace consulta dinámicamente los filtros adecuados para cada métrica. Para agregar un filtro, elija el símbolo **\$1** situado junto a la etiqueta **Filtros** en el editor de consultas de Dynatrace, seleccione el campo que desee filtrar, seleccione el operador que desee utilizar y, a continuación, seleccione un valor por el que filtrar. El origen de datos de Dynatrace le permite crear grupos de filtros que puede unir para crear comparaciones lógicas complejas. En la mayoría de los casos de uso, los grupos de filtros no son necesarios. Al crear filtros con etiquetas, independientemente de la conjunción seleccionada, Dynatrace siempre usará AND. Dynatrace no admite filtros OR con etiquetas.
+ `Alias`: hay dos tipos diferentes de alias que encontrará al utilizar el origen de datos de Dynatrace. El primero es un alias estático. Hay un alias de este tipo disponible en todas las consultas que cree y el nombre del alias comienza por una letra minúscula. El segundo es un alias dinámico, que cambia en función de la métrica que utilice en la consulta, y el nombre del alias comienza por una letra mayúscula. El complemento de Dynatrace admite varios alias diferentes: `Metric Names`, `Aggregation`, `Display Name`, `Host` y `Description`.
| Name | Valor |
| --- | --- |
| \$1name | integrado: apps.other. keyUserActions. reportedErrorCount.os |
| \$1aggregation | auto,value |
| \$1displayName | Recuento de errores notificados (por acción clave del usuario, sistema operativo) [móvil, personalizado] |
**Tipo de consulta de problemas**
+ `Problem Query Type`: seleccione un tipo de consulta de problemas. Actualmente, solo se admite el tipo de consulta de problemas con la fuente. Para obtener información sobre el tipo de consulta relacionada con el problema de la fuente, consulte [Merge transformation](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation).
+ `Status Filter`: filtre los problemas resultantes por estado.
+ `Impact Filter`: filtre los problemas resultantes por nivel de impacto.
+ `Severity Filter`: filtre los problemas resultantes por nivel de gravedad.
+ `Expand Details`: incluya los eventos relacionados con la respuesta, si están definidos.
#### Uso de variables de plantilla
Para agregar una nueva variable de consulta de Dynatrace, consulte [Add a new template variable](variables-types.md#add-a-query-variable). Utilice su origen de datos de Dynatrace como origen de datos para las siguientes consultas disponibles:
+ `Query type`: seleccione un tipo de consulta. El tipo de consulta asocia algunos datos a alguna clave o descriptor.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/dynatrace-AMG-datasource.html)
+ `Regex`: (opcional) filtre cualquiera de los valores devueltos por la consulta con una expresión regular.
**nota**
`Multi-value` y `Include All option` actualmente no son compatibles con el origen de datos de Dynatrace.
Después de crear una variable, puede encontrarla en el menú desplegable **Métricas**.
##### Importación de un panel para Dynatrace
Para importar un panel, consulte [Importación de un panel](dashboard-export-and-import.md#importing-a-dashboard). Los paneles importados se encuentran en **Configuración** > **Orígenes de datos** > seleccione su origen de datos de Dynatrace > seleccione la pestaña **Paneles** para ver los paneles prediseñados disponibles.