Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connectez-vous à une source de données Dynatrace
Source de données pour [https://www.dynatrace.com/](https://www.dynatrace.com). Pour utiliser cette source de données, vous devez disposer d'un compte Dynatrace.
**Note**
Cette source de données est réservée à Grafana Enterprise. Pour de plus amples informations, veuillez consulter [Gérer l'accès aux plug-ins d'entreprise](upgrade-to-enterprise-plugins.md).
En outre, dans les espaces de travail qui prennent en charge la version 9 ou une version plus récente, cette source de données peut nécessiter l'installation du plug-in approprié. Pour de plus amples informations, veuillez consulter [Étendez votre espace de travail avec des plugins](grafana-plugins.md).
**Limitations connues**
Les variables de modèle ne peuvent pas être sélectionnées à plusieurs reprises. Seule la sélection unique est prise en charge.
Seule la métrique v2 APIs est prise en charge.
## Caractéristiques
### Fonctions de base
+ Variables du modèle
+ Noms des métriques
+ Sélection unique uniquement (**pas de sélection multiple**)
+ Filtres ad hoc
+ Annotations
+ Non pris en charge actuellement
+ Aliasing
+ Noms des métriques
+ Agrégation
+ Nom d’affichage
+ Host (Hôte)
+ Description
+ Alerte
+ Support complet en matière d'alertes
### Caractéristiques spécifiques de Dynatrace
Supporte les métriques intégrées et personnalisées à l'aide de l'API Dynatrace metrics v2. [Pour plus d'informations, consultez la documentation de Dynatrace : [Metrics API v2](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/) et Metric ingestion.](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/)
En fonction de la métrique, l'API peut prendre en charge des options de transformation supplémentaires.
## Autorisations Dynatrace
Vous aurez besoin des autorisations suivantes dans Dynatrace : autorisation de lecture des métriques à l'aide de l'API V2 (metrics.read) - Permission de lecture des entités à l'aide de l'autorisation API V2 (entities.read)
## Obtenez une clé d'API auprès de Dynatrace
Pour configurer un jeton d'API, voir API [Dynatrace - Jetons](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication/?api-token%3C-%3Epersonal-access-token=api-token) et authentification
Définissez les `entities.read` autorisations `metrics.read` et pour votre jeton d'API.
### Configuration
1. **Choisissez **Paramètres/Sources de données** dans l'interface utilisateur logique du serveur Grafana, puis choisissez Ajouter une source de données.**
1. Sur la page **Ajouter une source de données**, filtrez **Dynatrace** et sélectionnez le plugin Dynatrace.
1. La configuration d'une source de données Dynatrace nécessite les paramètres suivants :
+ `Name`- Le nom que vous souhaitez appliquer à la source de données Dynatrace (par défaut : Dynatrace).
+ `Dynatrace API Type`- Le type d'instance Dynatrace à laquelle vous vous connectez. C'est soit, `SaaS` soit`Managed Cluster`.
+ `Dynatrace API Token`- Il s'agit du jeton d'API que vous avez généré à l'étape précédente.
Les deux paramètres suivants varient selon que vous êtes un Dynatrace (SaaS) ou géré.
+ Dans un exemple de SaaS`yfc55578.live.dynatrace.com`, votre **ID d'environnement** serait`yfc55578`.
+ Dans l'exemple géré de`yd8888.managed-sprint.dynalabs.io/e/abc99984-3af2-55tt-72kl-0672983gc45`, votre **ID d'environnement** serait `abc99984-3af2-55tt-72kl-0672983gc45` et votre **domaine** serait `yd8888.managed-sprint.dynalabs.io`
1. Une fois que toutes les valeurs de configuration ont été définies, choisissez **Enregistrer et tester** pour valider la configuration et enregistrer vos modifications.
### Interrogez la source de données
Utilisez l'éditeur de requêtes pour interroger les métriques et les problèmes de Dynatrace. Le type de requête peut être `metric` ou`problem`.
**Type de requête métrique**
+ `Metric`— Sélectionnez la métrique que vous souhaitez consulter. **Pour obtenir à nouveau la liste des métriques auprès de Dynatrace, cliquez sur le bouton Actualiser.**
+ `Aggregations`— Sélectionnez l'agrégation que vous souhaitez utiliser pour une métrique spécifique. Choisissez la valeur des agrégations pour modifier le type d'agrégation ou choisissez **\$1** pour ajouter une autre agrégation.
+ `Transformations`— Vous pouvez sélectionner des transformations dans l'éditeur de requêtes. Entrez ensuite un certain nombre de paramètres dans la transformation sélectionnée. Actuellement, seule la transformation par fusion est prise en charge. Pour plus d'informations sur les transformations de fusion, consultez la section [Transformation de fusion](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation).
+ `Filters`— La source de données Dynatrace interroge dynamiquement les filtres appropriés pour chaque métrique. Pour ajouter un filtre, cliquez sur le symbole **\$1** à côté de l'étiquette **Filtres** dans l'éditeur de requêtes Dynatrace, sélectionnez le champ à filtrer, sélectionnez l'opérateur à utiliser, puis sélectionnez une valeur à filtrer. La source de données Dynatrace vous permet de créer des groupes de filtres que vous pouvez associer pour créer des comparaisons logiques complexes. Dans la plupart des cas d'utilisation, les groupes de filtres ne sont pas obligatoires. Lors de la création de filtres avec des tags, quelle que soit la conjonction sélectionnée, Dynatrace utilisera toujours AND. Dynatrace ne prend pas en charge les filtres OR dotés de balises.
+ `Alias`— Il existe deux types d'alias différents que vous rencontrerez lors de l'utilisation de la source de données Dynatrace. Le premier est un alias statique. Un alias de ce type est disponible pour chaque requête que vous créez, et le nom de l'alias commence par une lettre minuscule. Le second est un alias dynamique, qui change en fonction de la métrique que vous utilisez dans votre requête, et le nom de l'alias commence par une lettre majuscule. Le plugin Dynatrace prend en charge plusieurs alias différents :`Metric Names`,,`Aggregation`, `Display Name` et. `Host` `Description`
| Nom | Value |
| --- | --- |
| \$1name | intégré : apps.other. keyUserActions. reportedErrorCount.os |
| \$1aggregation | auto, valeur |
| \$1displayName | Nombre d'erreurs signalées (par action clé de l'utilisateur, système d'exploitation) [mobile, personnalisé] |
**Type de requête de problèmes**
+ `Problem Query Type`— Sélectionnez un type de requête posant problème. Actuellement, seul le type de requête présentant un problème d'alimentation est pris en charge. Pour plus d'informations sur le type de requête présentant un problème de flux, voir [Fusion et transformation](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)
+ `Status Filter`— Filtrez les problèmes liés aux résultats en fonction de leur statut.
+ `Impact Filter`— Filtrez les problèmes de résultat en fonction du niveau d'impact.
+ `Severity Filter`— Filtrez les problèmes qui en résultent en fonction du niveau de gravité.
+ `Expand Details`— Inclut les événements associés à la réponse, si elle est définie.
#### Utilisation de variables de modèle
Pour ajouter une nouvelle variable de requête Dynatrace, voir [Ajouter une nouvelle](variables-types.md#add-a-query-variable) variable de modèle. Utilisez votre source de données Dynatrace comme source de données pour les requêtes disponibles suivantes :
+ `Query type`— Sélectionnez un type de requête. Le type de requête associe certaines données à une clé ou à un descripteur.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/dynatrace-AMG-datasource.html)
+ `Regex`— (Facultatif) Filtrez toutes les valeurs renvoyées par votre requête à l'aide d'une expression régulière.
**Note**
`Multi-value`et ne `Include All option` sont actuellement pas pris en charge par la source de données Dynatrace.
Après avoir créé une variable, vous pouvez la trouver dans le menu déroulant **Métrique**.
##### Importer un tableau de bord pour Dynatrace
Pour importer un tableau de bord, consultez[Importation d'un tableau de bord](dashboard-export-and-import.md#importing-a-dashboard). Les tableaux de bord importés se trouvent dans **Configuration** > **Sources de données** > sélectionnez votre source de données Dynatrace > sélectionnez l'onglet Tableaux de bord pour voir les **tableaux** de bord prédéfinis disponibles.