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. # Étendez votre espace de travail avec des plugins Plug-ins Grafana *Les plugins Grafana permettent* de se connecter à de nouvelles sources de données ou d'ajouter une visualisation ou d'autres fonctionnalités à l'espace de travail. En gros, les plugins sont de trois types : + **Plug-ins** de panneau : les plug-ins de panneau ajoutent de nouveaux types de visualisation qui peuvent être utilisés dans vos tableaux de bord. Ils définissent le rendu des données dans le frontend. + **Plug-ins de source** de données — Les plug-ins de source de données communiquent avec des sources de données externes et renvoient les données dans un format utilisable par Grafana. + **Plug-ins d'application** — Applications, également appelées plugins d'applications. Ils incluent des sources de données groupées et des panneaux, et peuvent fournir une expérience cohérente au sein de votre espace de travail Grafana. **Note** Lorsqu'Amazon détermine qu'un plugin échoue souvent ou n'a pas été maintenu, il est possible qu'il soit supprimé de la liste des plugins disponibles dans la console. Pour les espaces de travail Amazon Managed Grafana compatibles avec la version 9 ou ultérieure, vous pouvez activer la gestion des plugins. Cela permet aux administrateurs de l'espace de travail d'installer ou de désinstaller des plug-ins du *catalogue de plug-ins*. ## Trouvez des plugins avec le catalogue de plugins Catalogue de plugins Votre espace de travail Amazon Managed Grafana inclut une page qui affiche tous vos plug-ins installés et une liste de tous les plug-ins disponibles pour installation dans votre espace de travail. Cette page est le *catalogue des plugins*. Outre les plugins installés par défaut, vous pouvez installer jusqu'à 50 plugins supplémentaires. Les plugins disponibles se répartissent globalement dans les catégories suivantes : + **AWS Sources de données** — Il s'agit d'un plugin d'application, fourni par Amazon Managed Grafana, qui permet de découvrir facilement les AWS ressources de votre compte. Il est installé par défaut. Pour de plus amples informations, veuillez consulter [Utilisez le plugin AWS Data Sources pour rechercher des AWS données](aws-datasources-plugin.md). + **Plugins principaux** — Ces plugins sont fournis par défaut dans Grafana. Ils incluent des sources de données populaires et des visualisations de panneaux. Ils sont étiquetés comme **Core** dans le catalogue des plugins. Ils sont installés par défaut et ne peuvent pas être supprimés. + **Plug-ins d'entreprise** — Ces plugins sont disponibles pour les espaces de travail Grafana dotés d'une licence d'entreprise. Ils ne sont pas installés par défaut. Ils sont étiquetés **Enterprise** dans le catalogue de plugins. Ils ne peuvent être installés que si vous possédez une licence d'entreprise valide. Pour plus d'informations sur la mise à niveau d'un espace de travail vers une licence Enterprise, consultez[Gestion de votre accès aux plugins Amazon Managed Grafana Enterprise](AMG-workspace-manage-enterprise.md). + **Plugins communautaires** — Ces plugins sont fournis pour les espaces de travail Grafana à partir de diverses sources, notamment Grafana Labs et d'autres. AWS Dans les espaces de travail Grafana compatibles avec la version 9 ou une version plus récente, ceux-ci ne sont pas installés par défaut (certains d'entre eux sont installés automatiquement dans les espaces de travail antérieurs). Il s'agit généralement de plugins open source. Vous pouvez installer ou supprimer ces plugins. **Note** L'utilisation de plugins communautaires est laissée à votre discrétion. Dans le cadre du [modèle de responsabilité partagée](security.md) entre vous et AWS, vous êtes censé comprendre ce que vous installez dans votre espace de travail pour ces plugins tiers. Vous êtes également responsable des plugins qui répondent à vos besoins en matière de sécurité. **Support des plugins** Les plugins proviennent d'une grande variété de sources et leur support varie. + **AWS Plugin Data Sources** — Ce plugin est fourni et pris en charge par AWS. + **Plug-ins d'entreprise — Les plugins** d'entreprise sont pris en charge à la fois par Grafana Labs AWS et par Grafana Labs. Vous pouvez soumettre des problèmes par l'intermédiaire de l'une ou l'autre des équipes d'assistance. + **Plug-ins principaux** — Les plug-ins principaux et autres plugins fournis par AWS ou Grafana Labs sont pris en charge dans Amazon Managed Grafana by. AWS Vous pouvez soumettre un problème GitHub pour des corrections de bogues ou des améliorations, ou créer un ticket auprès de AWS Grafana Labs. + **Plugins communautaires — Les plugins** communautaires non créés par Grafana Labs AWS ou créés par Grafana Labs sont généralement pris en charge par le biais de GitHub problèmes ou d'autres forums. Dans ces cas, les informations de support sont incluses dans les détails du plugin dans le catalogue de plugins. [Vous pouvez également signaler des problèmes relatifs aux plug-ins via les GitHub forums d'[Amazon Managed Grafana ou Grafana](https://github.com/aws/amazon-managed-grafana-roadmap/issues).](https://github.com/grafana/grafana/issues) **Versions du plugin** La plupart des plugins sont mis à jour régulièrement. Le catalogue de plugins d'un espace de travail Grafana géré par Amazon présente les versions les plus récentes d'un plugin, et vous choisissez la version à installer. Lorsqu'une version obsolète d'un plugin présente un problème de sécurité connu, la version obsolète n'est plus disponible. Vous pouvez également [mettre à jour](#update-plugin) les plugins déjà installés. **Note** Parfois, une nouvelle version d'un plugin est mise à disposition pour résoudre un problème de sécurité dans un plugin installé. En cas de problème grave, Amazon Managed Grafana peut automatiquement mettre à jour le plug-in de vos espaces de travail vers la version contenant le correctif. ## Gérez les plugins avec le catalogue de plugins Gérer les plugins Vous gérez les plug-ins de votre espace de travail Amazon Managed Grafana à partir du catalogue de plugins. Vous ne pouvez installer que les plug-ins répertoriés dans le catalogue de plug-ins de votre espace de travail. Ce qui suit décrit les conditions requises pour utiliser le catalogue de plugins et comment trouver le catalogue de plugins. **Conditions préalables** + Vous devez disposer d'un [espace de travail Grafana géré par Amazon](AMG-create-workspace.md) compatible avec la version 9 et disposer d'un compte permettant de vous connecter à cet espace de travail. + La [gestion des plug-ins doit être activée](AMG-configure-workspace.md) dans l'espace de travail. + Votre compte utilisateur doit être celui d'[administrateur de votre espace de travail Amazon Managed Grafana](Grafana-user-roles.md). + Pour installer et utiliser des plug-ins Enterprise, vous devez d'abord [passer à une licence Enterprise](AMG-workspace-manage-enterprise.md). **Pour consulter le catalogue des plugins** 1. Connectez-vous à votre espace de travail Amazon Managed Grafana. 1. Dans le menu de gauche, choisissez **Administration**, puis **Plugins**. Cela ouvre le catalogue de plugins. 1. Par défaut, le catalogue de plugins répertorie les plugins installés. Pour afficher tous les plugins disponibles, choisissez **Tous** sous le filtre d'**état** en haut du catalogue. Les plugins installés incluent une balise indiquant « **Installé** ». ## Installer ou supprimer un plugin **Note** Vous devez remplir les conditions requises décrites dans la section précédente, sinon vous ne serez pas autorisé à modifier les plugins. **Pour installer ou supprimer un plugin Grafana** 1. Accédez au catalogue des plugins. 1. Par défaut, le catalogue de plugins répertorie uniquement les plugins installés. Pour afficher tous les plugins disponibles, choisissez **Tous** sous le filtre d'**état** en haut du catalogue. Les plugins installés incluent une balise indiquant « **Installé** ». 1. Sélectionnez le plugin à installer ou à désinstaller. Par exemple, si vous souhaitez supprimer la source de *données Datadog*, sélectionnez le plugin **Datadog**. 1. Sur la page de détails du plugin, choisissez l'option de désinstallation ou d'installation. 1. Après l'installation d'un plugin, la synchronisation des modifications dans toutes les parties de l'espace de travail peut prendre jusqu'à quelques minutes. Il est conseillé d'attendre quelques minutes avant d'utiliser le nouveau plugin. **Note** Vous pouvez installer 50 plugins dans un espace de travail (en plus des plugins Core par défaut). ## Mettre à jour un plugin **Pour mettre à jour un plugin Grafana existant** 1. Connectez-vous à votre espace de travail Amazon Managed Grafana. 1. Dans le menu de gauche, choisissez **Administration**, puis **Plugins**. Cela ouvre le catalogue de plugins, répertoriant uniquement les plugins installés. 1. Sélectionnez le plugin à mettre à jour. 1. Sur la page de détails du plugin, vérifiez si une mise à jour est disponible. Si tel est le cas, choisissez l'option de mise à jour du plugin et choisissez la version vers laquelle effectuer la mise à jour. **Note** Si vous voyez une note indiquant que vous n'êtes pas autorisé à modifier le plug-in, vérifiez que la [gestion des plug-ins est activée](AMG-configure-workspace.md) pour votre espace de travail. Vous devez également être [administrateur de l'espace](Grafana-user-roles.md) de travail Amazon Managed Grafana. # Utilisez le plugin AWS Data Sources pour rechercher des AWS données AWS Plug-in de sources de données AWS fournit un plug-in d'application pour faciliter la découverte et l'utilisation des AWS ressources en tant que sources de données dans votre espace de travail Amazon Managed Grafana. Le plug-in *AWS Data Sources* est installé par défaut dans un nouvel espace de travail. Le plug-in AWS Data Sources nécessite des autorisations pour accéder à vos ressources à des fins de découverte. Pour de plus amples informations, veuillez consulter [Autorisations requises](#aws-ds-plugin-permissions). ## Ouvrez le plugin Sources de AWS données **Pour ouvrir le plug-in AWS Data Sources** 1. Connectez-vous à votre espace de travail Amazon Managed Grafana. 1. Dans le **menu** en haut à gauche, choisissez **Applications**, puis **Sources de AWS données**. L'interface du plug-in AWS Data Sources apparaît et répertorie AWS les services dans lesquels vous pouvez rechercher des ressources. ## Découvrez les ressources **Pour découvrir les ressources de votre Compte AWS** 1. Ouvrez le plugin AWS Data Sources. 1. Dans la liste des AWS services, sélectionnez celui pour lequel vous souhaitez rechercher des ressources à utiliser comme source de données. Par exemple, sélectionnez **Amazon Managed Service pour Prometheus**. Cela vous amènera à l'onglet **Sources de données**, avec le **service** sélectionné pour vous. 1. Choisissez la AWS région dans laquelle vous souhaitez trouver des ressources. Par exemple, sélectionnez`US East (N. Virginia)`. **Note** Pour trouver des ressources, le plugin doit disposer des [autorisations](#aws-ds-plugin-permissions) appropriées pour accéder à ce service dans cette région. 1. Certains services peuvent disposer de plusieurs ressources dans une région. S'il existe plusieurs ressources dans la région, le plug-in AWS Data Sources fournit une liste parmi laquelle choisir. Dans la liste des ressources (dans ce cas, Amazon Managed Service for Prometheus), sélectionnez la ressource que vous souhaitez utiliser comme source de données. Par exemple, la sélection d'un espace de travail Amazon Managed Service pour Prometheus configurera cette ressource en tant que source de données. La source de données est prête à être utilisée dans vos tableaux de bord ou à surveiller avec Amazon Managed Grafana. 1. Les ressources de ce service et de cette région que vous avez mises en service apparaissent au bas de la page. (Facultatif) Vous pouvez choisir **Accéder aux paramètres** pour afficher et modifier les paramètres de cette source de données. **Note** Le plug-in AWS Data Sources dépend des plugins de source de données individuels installés dans votre espace de travail. Par exemple, si vous souhaitez utiliser cette AWS X-Ray fonctionnalité, le plug-in de source de données X-Ray doit être installé à partir du [catalogue de plug-ins](grafana-plugins.md#manage-plugins). ## Versions et mise à jour du plugin Le plugin AWS Data Sources est régulièrement mis à jour. La version installée avec un nouvel espace de travail n'est généralement pas la version la plus récente. Les versions plus récentes peuvent comporter davantage de fonctionnalités que celle installée dans votre espace de travail. Par exemple, une version plus récente peut prendre en charge des AWS services supplémentaires en tant que sources de données. Pour voir les modifications apportées à chaque version du plugin AWS Data Sources, vous pouvez consulter le [Changelog](https://grafana.com/grafana/plugins/aws-datasource-provisioner-app/?tab=changelog). Pour effectuer une mise à jour vers une version plus récente du plugin, suivez les instructions standard pour[Mettre à jour un plugin](grafana-plugins.md#update-plugin). **Note** Si vous effectuez une mise à jour vers une version plus récente du plug-in AWS Data Sources, vous devez fournir des [autorisations supplémentaires pour les](#aws-ds-plugin-permissions) nouvelles sources de données qui ne sont pas gérées par Amazon Managed Grafana. ## Autorisations requises Le plugin AWS Data Sources nécessite une autorisation pour accéder à vos AWS ressources. Le moyen le plus simple d'y parvenir est d'autoriser Amazon Managed Grafana à gérer les autorisations pour vous. Pour savoir comment configurer des autorisations gérées par le service pour les sources de données, consultez. [Gérer les autorisations pour les sources de données et les canaux de notification](AMG-datasource-and-notification.md) Amazon Managed Grafana peut gérer les autorisations pour les AWS ressources incluses par défaut dans le plug-in AWS Data Sources. Si vous mettez à jour le plug-in AWS Data Sources vers une version plus récente que celle incluse par défaut dans votre espace de travail, il est possible qu'il prenne en charge les AWS ressources dont les autorisations ne sont pas gérées automatiquement par Amazon Managed Grafana. Dans ces cas, vous devez ajouter vous-même les autorisations. Par exemple, AWS IoT TwinMaker il a été ajouté à une version récente du plugin (version 1.9.0), et les autorisations associées à celui-ci ne sont pas gérées par Amazon Managed Grafana. Pour en savoir plus sur les autorisations pour une source de données spécifique, consultez les détails de cette source de données fournis dans la [Connexion aux sources de données](AMG-data-sources.md) section. Par exemple, [Se connecter à une source AWS IoT TwinMaker de données](AMG-iot-twinmaker.md) cette section contient des informations sur l'octroi d'autorisations d'accès à Amazon Managed Grafana. AWS IoT TwinMaker