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 OpenSearch de données Amazon Service **Note** 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). Avec Amazon Managed Grafana, vous pouvez ajouter Amazon OpenSearch Service en tant que source de données en utilisant l'option de configuration de la source de AWS données dans la console de l'espace de travail Grafana. Cette source de données prend en charge les domaines de OpenSearch service, qui exécutent OpenSearch des clusters, ainsi que les anciens clusters Elasticsearch. L' AWS option de configuration de la source de données simplifie l'ajout de OpenSearch Service en tant que source de données en découvrant vos comptes de OpenSearch service existants et en gérant la configuration des informations d'authentification requises pour y accéder OpenSearch. Vous pouvez utiliser cette méthode pour configurer l'authentification et ajouter le OpenSearch service en tant que source de données, ou vous pouvez configurer manuellement la source de données et les informations d'authentification nécessaires en utilisant la même méthode que sur un serveur Grafana autogéré. La source de données du OpenSearch service prend en charge le langage PPL (Piped Processing Language). Pour plus d'informations sur PPL, consultez [Interroger les données Amazon OpenSearch Service à l'aide du langage de traitement pipé](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html). Vous pouvez utiliser la source de données du OpenSearch service pour effectuer de nombreux types de OpenSearch requêtes simples ou complexes afin de visualiser les journaux ou les métriques qui y sont stockés OpenSearch. Vous pouvez également annoter les événements du journal dans OpenSearch vos graphiques. **Topics** + [ # Utiliser la configuration de la source de AWS données pour ajouter un OpenSearch service en tant que source de données ](ES-adding-AWS-config.md) + [ # Ajouter manuellement Amazon OpenSearch Service en tant que source de données ](ES-adding-the-data-source.md) + [ ## OpenSearch Paramètres du service ](#ES-settings) + [ # Utilisation de la source OpenSearch de données Amazon Service ](ES-use-datasource.md) + [ # Amazon OpenSearch Service sans serveur ](datasources-opensearch-serverless.md) + [ # Support Traces ](datasources-opensearch-traces.md) # Utiliser la configuration de la source de AWS données pour ajouter un OpenSearch service en tant que source de données Pour utiliser la configuration AWS des sources de données, vous devez d'abord utiliser la console Amazon Managed Grafana pour activer les rôles IAM gérés par le service qui accordent à l'espace de travail les politiques IAM nécessaires pour lire les ressources du OpenSearch service dans votre compte ou dans l'ensemble de vos unités organisationnelles. Vous utilisez ensuite la console d'espace de travail Amazon Managed Grafana pour ajouter le OpenSearch service en tant que source de données. **Pour utiliser la configuration de la source de AWS données pour ajouter un OpenSearch service en tant que source de données** 1. Ouvrez la console Amazon Managed Grafana à l'adresse. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 1. Dans le coin supérieur gauche de la page, cliquez sur l’icône du menu, puis sur **Tous les espaces de travail**. 1. Choisissez le nom de l'espace de travail. 1. Si vous n'avez pas choisi d'utiliser les autorisations gérées par les services pour cet espace de travail lorsque vous l'avez créé, passez des autorisations gérées par le client à des autorisations gérées par les services afin de vous assurer que les rôles et politiques IAM appropriés sont activés pour utiliser l'option de configuration de la AWS source de données dans la console de l'espace de travail Grafana. Pour ce faire, choisissez l'icône de modification par **rôle IAM**, puis choisissez **Service géré**, **Enregistrer les modifications**. Pour de plus amples informations, veuillez consulter [Autorisations et politiques Amazon Managed Grafana pour les sources de données AWS](AMG-manage-permissions.md). 1. Choisissez l'onglet **Sources de données**. Cochez ensuite la case **Amazon OpenSearch Service**, puis choisissez **Actions**, **Activer la politique gérée par le service**. 1. Choisissez à nouveau l'onglet **Sources de données**, puis sélectionnez **Configurer dans Grafana** dans la ligne **Amazon OpenSearch Service**. 1. Connectez-vous à la console de l'espace de travail Grafana à l'aide d'IAM Identity Center si nécessaire. 1. Dans la barre de navigation de gauche de la console de l'espace de travail Grafana, choisissez l' AWS icône, puis choisissez **AWS services, **Amazon OpenSearch ** Service**. 1. Sélectionnez la région dans laquelle vous souhaitez qu'Amazon Managed Grafana recherche pour découvrir les ressources du OpenSearch service, puis sélectionnez les comptes et les domaines de OpenSearch service que vous souhaitez ajouter, configurez les paramètres d'index, puis choisissez **Ajouter des sources de données**. # Ajouter manuellement Amazon OpenSearch Service en tant que source de données **Pour ajouter manuellement la source OpenSearch de données Amazon Service** 1. Dans le menu latéral de la console Grafana, choisissez l'**AWS**icône, puis choisissez Sources de **données**. 1. Choisissez la source ** OpenSearch de données Amazon Service**. Si nécessaire, vous pouvez commencer à taper **OpenSearch** dans le champ de recherche pour vous aider à le trouver. 1. Choisissez la **région** à partir de laquelle vous souhaitez rechercher des données. 1. Choisissez **Add data source**. **Note** Si le lien **Sources de données** n'apparaît pas dans le menu latéral, cela signifie que votre utilisateur actuel n'a pas le `Admin` rôle. ## OpenSearch Paramètres du service | Nom | Description | | --- | --- | | Name | Le nom de la source de données. C'est ainsi que vous voyez la source de données dans les panneaux et les requêtes. | | Default | La source de données par défaut signifie qu'elle sera présélectionnée pour les nouveaux panneaux. | | Url | Le point de terminaison de votre domaine de OpenSearch service. Le point de terminaison prend le format suivant : https://search-my-domain.us-east-1.es.amazonaws.com. | | Access | Serveur (par défaut) = L'URL doit être accessible depuis le backend/serveur Grafana. Navigateur = L'URL doit être accessible depuis le navigateur. | Le mode d'accès contrôle la manière dont les demandes adressées à la source de données seront traitées. Le serveur doit être le moyen préféré si rien d'autre n'est indiqué. ### Mode d'accès au serveur (par défaut) Toutes les demandes sont effectuées depuis le navigateur vers le backend ou le serveur de Grafana, qui les transmet à la source de données, contournant ainsi les éventuelles exigences de partage de ressources entre origines (CORS). Si vous sélectionnez ce mode d'accès, l'URL doit être accessible depuis le backend ou le serveur Grafana. ### Accès (direct) au navigateur Amazon Managed Grafana ne prend pas en charge l'accès direct par navigateur. ### Paramètres de l'index Ici, vous pouvez définir une valeur par défaut pour `time field` et spécifier le nom de votre OpenSearch index. Vous pouvez utiliser un modèle temporel pour le nom de l'index ou un caractère générique. ### OpenSearch/Version d'Elasticsearch Spécifiez votre version OpenSearch ou celle de votre ancienne version d'Elasticsearch dans le menu déroulant des versions. La version est importante car il existe des différences dans la façon dont les requêtes sont composées pour chaque version. Grafana prend actuellement en charge OpenSearch la version 1.0.x. Les versions prises en charge d'Elasticsearch sont `2.0+``5.0+`, `5.6+``6.0+`, et. `7.0+` La valeur `5.6+` signifie la version 5.6 ou supérieure, mais inférieure à 6.0. La valeur `6.0+` signifie la version 6.0 ou supérieure, mais inférieure à 7.0. Enfin, `7.0+` signifie la version 7.0 ou supérieure, mais inférieure à 8.0. ### Intervalle de temps minimum Limite inférieure pour le regroupement automatique par intervalle de temps. Il est recommandé de régler la fréquence d'écriture, par exemple `1m` si vos données sont écrites toutes les minutes. Cette option peut également se trouver overridden/configured dans un panneau de tableau de bord sous les options de source de données. Cette valeur **doit** être formatée sous la forme d'un nombre suivi d'un identifiant horaire valide, par exemple `1m` (1 minute) ou `30s` (30 secondes). Les identifiants horaires suivants sont pris en charge. | Identifiant | Description | | --- | --- | | y | Année | | M | Mois | | w | semaine | | d | jour | | h | Heure | | m | Minute | | s | Seconde | | ms | Milliseconde | ### Journaux Deux paramètres, `Message field name` et`Level field name`, peuvent éventuellement être configurés à partir de la page des paramètres de la source de données pour déterminer les champs qui seront utilisés pour les messages de journal et les niveaux de journalisation lors de la visualisation des connexions. [Explorez](explore.md) Par exemple, si vous utilisez une configuration par défaut de Filebeat pour envoyer les journaux au OpenSearch Service, la configuration suivante devrait fonctionner. + **Nom du champ du message :** message + **Nom du champ de niveau : fields.level** ### Liaisons de données Les liens de données créent un lien à partir d'un champ spécifié accessible dans la vue des journaux dans Explore. Chaque configuration de liaison de données comprend les éléments suivants : + **Champ** : nom du champ utilisé par le lien de données. + **URL/requête** — Si le lien est externe, entrez l'URL complète du lien. S'il s'agit d'un lien interne, cette entrée sert de requête pour la source de données cible. Dans les deux cas, vous pouvez interpoler la valeur du champ à l'aide d'une `${__value.raw }` macro. + **Lien interne** : sélectionnez cette option s'il s'agit d'un lien interne ou externe. Si le lien est interne, un sélecteur de source de données vous permet de sélectionner la source de données cible. Seules les sources de données de suivi sont prises en charge. # Utilisation de la source OpenSearch de données Amazon Service ## Éditeur de requêtes métriques L'éditeur de OpenSearch requêtes vous permet de sélectionner plusieurs indicateurs et de les regrouper selon plusieurs termes ou filtres. Utilisez les icônes plus et moins situées à droite pour les add/remove indicateurs ou regroupez-les par clauses. Certaines métriques et clauses de regroupement par comportent des options. Choisissez le texte de l'option pour développer la ligne \$1 afin d'afficher et de modifier la métrique ou de la regrouper par options. ## Utilisation du langage de traitement canalisé (PPL) La source de données Amazon OpenSearch Service prend en charge le langage PPL (Piped Processing Language), qui permet des fonctionnalités de requête et de visualisation plus simples mais puissantes pour. OpenSearch Le PPL permet aux clients d'explorer et de rechercher des données sans avoir à composer de longues instructions DSL ( OpenSearch Domain Specific Language) ou à écrire des requêtes à l'aide d'objets JSON. Avec PPL, vous pouvez écrire des requêtes sous la forme d'un ensemble de commandes délimitées par des canaux similaires aux canaux UNIX. Prenons l'exemple de requête DSL suivant comme exemple : ``` GET opensearch_sample_data_logs/_search{"from":0,"size":0,"timeout":"1m","query":{"bool":{"should":[{"term":{"response.keyword":{"value":"404","boost":1}}},{"term":{"response.keyword":{"value":"503","boost":1}}}],"adjust_pure_negative":true,"boost":1}},"sort":[{"_doc":{"order":"asc"}}],"aggregations":{"composite_buckets":{"composite":{"size":1000,"sources":[{"host":{"terms":{"field":"host.keyword","missing_bucket":true,"order":"asc"}}},{"response":{"terms":{"field":"response.keyword","missing_bucket":true,"order":"asc"}}}]},"aggregations":{"request_count":{"value_count":{"field":"request.keyword"}},"sales_bucket_sort":{"bucket_sort":{"sort":[{"request_count":{"order":"desc"}}],"size":10}}}}}}> ``` La requête DSL précédente peut être remplacée par la commande PPL suivante qui est concise et lisible par l'homme. ``` source = opensearch_sample_data_logs | where response='404' or response='503' | stats count(request) as request_count by host, response | sort –request_count ``` Pour plus d'informations sur PPL, consultez la section [Interrogation des données Amazon OpenSearch Service à l'aide du langage de traitement canalisé.](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html) ## Dénomination des séries et modèles d'alias Vous pouvez contrôler le nom des séries chronologiques à l'aide du champ de `Alias` saisie. | Modèle | Description | | --- | --- | | \$1\$1term fieldname\$1\$1 | Remplacé par la valeur d'un terme Grouper par. | | \$1\$1metric\$1\$1 | Remplacé par le nom de la métrique (ex. Moyenne, minimale, maximale). | | \$1\$1field\$1\$1 | Remplacé par le nom du champ métrique. | ## Métriques du pipeline *Certaines agrégations métriques sont appelées agrégations de pipelines ; par exemple, *moyenne mobile* et dérivée.* OpenSearch les métriques du pipeline nécessitent une autre métrique sur laquelle se baser. Utilisez l'icône en forme d'œil à côté de la métrique pour empêcher les métriques d'apparaître dans le graphique. Cela est utile pour les métriques que vous avez uniquement dans la requête et destinées à être utilisées dans une métrique de pipeline. ## Création de modèles Au lieu de coder en dur des éléments tels que le nom du serveur, de l'application et du capteur dans vos requêtes métriques, vous pouvez utiliser des variables à leur place. Les variables sont affichées sous forme de boîtes de sélection déroulantes en haut du tableau de bord. Vous pouvez utiliser ces listes déroulantes pour modifier les données affichées dans votre tableau de bord. Pour plus d'informations sur les modèles et les variables de modèles, consultez[Modèles et variables](templates-and-variables.md). ### Variable de requête La source OpenSearch de données du service prend en charge deux types de requêtes que vous pouvez utiliser dans le champ *Requête* des variables de *requête*. La requête est écrite à l'aide d'une chaîne JSON personnalisée. | Query | Description | | --- | --- | | \$1"find": "fields", "type": "keyword"\$1 | Renvoie une liste de noms de champs avec le type d'indexkeyword. | | \$1"find": "terms", "field": "@hostname", "size": 1000\$1 | Renvoie une liste de valeurs pour un champ à l'aide de l'agrégation de termes. La requête utilisera la plage horaire actuelle du tableau de bord comme plage de temps pour la requête. | | \$1"find": "terms", "field": "@hostname", "query": ''\$1 | Renvoie une liste de valeurs pour un champ en utilisant l'agrégation de termes et un filtre de requête Lucene spécifié. La requête utilisera la plage horaire actuelle du tableau de bord comme plage de temps pour la requête. | Il existe une limite de taille par défaut de 500 pour les requêtes Terms. Pour définir une limite personnalisée, définissez la propriété de taille dans votre requête. Vous pouvez utiliser d'autres variables dans la requête. L'exemple de code suivant montre la définition de requête pour une variable nommée`$host`. ``` {"find": "terms", "field": "@hostname", "query": "@source:$source"} ``` Dans l'exemple précédent, nous utilisons une autre variable nommée `$source` dans la définition de la requête. Chaque fois que vous modifiez, à l'aide de la liste déroulante, la valeur actuelle de la `$source` variable, une mise à jour de la `$host` variable est initiée. Après la mise à jour, la `$host` variable contient uniquement les noms d'hôtes filtrés en fonction, dans ce cas, de la propriété du `@source` document. Ces requêtes renvoient par défaut les résultats par ordre des termes (qui peuvent ensuite être triés alphabétiquement ou numériquement comme pour n'importe quelle variable). Pour produire une liste de termes triés par nombre de documents (une liste de valeurs supérieures à N), ajoutez une `orderBy` propriété de`doc_count`. Cela permet de sélectionner automatiquement un tri décroissant. L'utilisation `asc` avec doc\$1count (une liste inférieure à N) peut être effectuée en configurant`order: "asc"`, mais elle est déconseillée car cela augmente l'erreur sur le nombre de documents. Pour conserver les termes dans l'ordre du nombre de documents, définissez la liste déroulante de **tri** de la variable sur **Désactivé**. Vous pouvez également toujours utiliser **Alphabétique** pour les trier à nouveau. ``` {"find": "terms", "field": "@hostname", "orderBy": "doc_count"} ``` ### Utilisation de variables dans les requêtes Il existe deux syntaxes : + `$`Exemple : @hostname : \$1hostname + `[[varname]]`Exemple : @hostname : [[hostname]] Pourquoi de deux manières ? La première syntaxe est plus facile à lire et à écrire, mais elle ne permet pas d'utiliser une variable au milieu d'un mot. Lorsque les options *Multi-valeurs* ou *Inclure toutes les valeurs* sont activées, Grafana convertit les étiquettes du texte brut en une condition compatible avec Lucene. Dans l'exemple précédent, nous avons une requête Lucene qui filtre les documents en fonction de la `@hostname` propriété à l'aide d'une variable nommée. `$hostname` Il utilise également une variable dans la zone de saisie du groupe *Termes* par champ. Cela vous permet d'utiliser une variable pour modifier rapidement le mode de regroupement des données. ## Annotations Les annotations vous permettent de superposer des informations détaillées sur les événements au-dessus des graphiques. Vous pouvez ajouter des requêtes d'annotation à l'aide du menu Tableau de bord ou de la vue Annotations. Grafana peut interroger n'importe quel OpenSearch index pour les événements d'annotation. Pour de plus amples informations, veuillez consulter [Annotations](dashboard-annotations.md). | Nom | Description | | --- | --- | | Query | Vous pouvez laisser la requête de recherche vide ou spécifier une requête Lucene. | | Time | Nom du champ horaire ; il doit s'agir d'un champ de date. | | Time End | Le nom facultatif du champ de fin d'heure doit être un champ de date. Si cette option est définie, les annotations seront marquées comme une zone située entre l'heure et la fin de l'heure. | | Text | Champ de description de l'événement. | | Tags | Nom de champ facultatif à utiliser pour les balises d'événements (il peut s'agir d'un tableau ou d'une chaîne CSV). | ## Interrogation des journaux L'interrogation et l'affichage des données du journal depuis OpenSearch sont disponibles dans Explore. Pour afficher vos journaux, sélectionnez la source OpenSearch de données du service, puis entrez éventuellement une requête Lucene. Pour de plus amples informations, veuillez consulter [Explorez](explore.md). ### Requêtes de journal Une fois le résultat renvoyé, le panneau du journal affiche une liste des lignes du journal et un graphique à barres où l'axe X indique l'heure et l'axe Y indique la fréquence ou le nombre. ### Filtrer les messages du journal Entrez éventuellement une requête Lucene dans le champ de requête pour filtrer les messages du journal. Par exemple, en utilisant une configuration Filebeat par défaut, vous devriez pouvoir `fields.level:error` afficher uniquement les messages du journal des erreurs. # Amazon OpenSearch Service sans serveur **Note** OpenSearch Le support Service Serverless n'est disponible qu'avec les espaces de travail Grafana qui exécutent Grafana version 9.4 ou ultérieure. Vous pouvez utiliser la source de données OpenSearch Service pour accéder aux données Amazon OpenSearch Service Serverless avec Amazon Managed Grafana. L'accès aux données est contrôlé par des politiques d'accès aux données. L'exemple suivant montre une politique qui permet aux utilisateurs d'interroger une collection et un index spécifiques. Assurez-vous de remplacer *`collection_name`**`index_name`*, et par *`principal_arn`* les valeurs correctes pour votre cas d'utilisation. ``` [ { "Rules": [ { "Resource": ["collection/{collection_name}"], "Permission": ["aoss:DescribeCollectionItems"], "ResourceType": "collection" }, { "Resource": ["index/{collection_name}/{index_name}"], "Permission": ["aoss:DescribeIndex", "aoss:ReadDocument"], "ResourceType": "index" } ], "Principal": ["principal_arn"], "Description": "read-access" } ] ``` # Support Traces Le OpenSearch plugin prend en charge l'affichage d'une liste de traces sous forme de tableau et d'une seule **trace dans Trace View**, qui montre la chronologie des intervalles de trace. **Note** L'interrogation OpenSearch des traces n'est disponible qu'à l'aide de requêtes Lucene. La prise en charge du suivi n'est disponible que pour les espaces de travail Grafana compatibles avec la version 9.4 ou ultérieure. Pour créer une requête affichant toutes les traces, utilisez le type de requête Lucene `Traces` avec une requête vide. Si nécessaire, sélectionnez le type de visualisation de **table**. La sélection d'un ID de trace dans le tableau ouvre cette trace dans la vue de trace. Pour créer une requête affichant une seule trace, utilisez la requête et`traceid: {traceId}`, si nécessaire, sélectionnez le type de visualisation **Traces**.