翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# プラグインを使用したワークスペースの拡張
<a name="grafana-plugins"></a>

*Grafana プラグイン*は、新しいデータソースに接続する機能を追加、またはワークスペースに視覚化やその他の機能を追加します。大きく分けて、プラグインには 3 つのタイプがあります。
+ **パネルプラグイン** – パネルプラグインはダッシュボードで使用できる新しい視覚化タイプを追加します。これらはフロントエンドのデータのレンダリングを定義します。
+ **データソースプラグイン** – データソースプラグインは外部データソースと通信して、Grafana が使用できる形式でデータを返します。
+ **アプリプラグイン** – アプリケーション、アプリプラグインとも呼ばれます。これにはバンドルデータソースとパネルが含まれ、Grafana ワークスペース内でまとまりのあるエクスペリエンスを提供できます。

**注記**  
Amazon は、プラグインが失敗することが多い、またはメンテナンスされていないと判断した場合、コンソールで使用可能なプラグインのリストからプラグインを削除することがあります。

バージョン 9 以降をサポートする Amazon Managed Grafana ワークスペースでは、プラグイン管理を有効化できます。これにより、ワークスペース管理者は*プラグインカタログ*からプラグインをインストールまたはアンインストールできます。

## プラグインカタログによるプラグインの検索
<a name="plugin-catalog"></a>

Amazon Managed Grafana ワークスペースには、インストール済みのすべてのプラグインと、ワークスペースにインストールできるすべてのプラグインのリストを示すページが含まれています。このページは*プラグインカタログ*です。デフォルトでインストールされるプラグインに加えて、最大 50 個のプラグインをインストールできます。

使用可能なプラグインは次のカテゴリに大別されます。
+ **AWS データソース** – これは、Amazon Managed Grafana が提供するアプリケーションプラグインで、アカウント内のリソースを簡単に検出 AWS できます。これはデフォルトでインストール済みです。詳細については、「[AWS データソースプラグインを使用して AWS データを検索する](aws-datasources-plugin.md)」を参照してください。
+ **コアプラグイン** – これらのプラグインは Grafana でデフォルトで提供されます。これには一般的なデータソースとパネルの視覚化が含まれます。プラグインカタログでは **[コア]** としてタグ付けされます。これらはデフォルトでインストールされ、削除できません。
+ **エンタープライズプラグイン** – これらのプラグインは、エンタープライズライセンスを持つ Grafana ワークスペースで利用可能です。これらはデフォルトではインストールされません。プラグインカタログでは **[エンタープライズ]** としてタグ付けされます。有効なエンタープライズライセンスがある場合にのみインストールできます。ワークスペースをエンタープライズライセンスにアップグレードする方法については、「[Amazon Managed Grafana Enterprise プラグインに対するアクセス権管理](AMG-workspace-manage-enterprise.md)」を参照してください。
+ **コミュニティプラグイン** – これらのプラグインは、Grafana Labs など、さまざまなソースの Grafana ワークスペース用に提供されています AWS。バージョン 9 以降をサポートする Grafana ワークスペースでは、デフォルトでインストールされません (以前のワークスペースにはこれらの一部が自動的にインストールされます)。これらは通常オープンソースプラグインです。これらのプラグインはインストールまたは削除できます。
**注記**  
コミュニティプラグインの使用はユーザーが自由に決定できます。お客様と AWS間の[責任共有モデル](security.md)の一環として、これらのサードパーティープラグインに関して、何をワークスペースにインストールするか理解する必要があります。また、お客様はセキュリティニーズを満たすプラグインについても責任を負います。

**プラグインサポート**

プラグインはさまざまなソースから提供され、それによってサポートが異なります。
+ **AWS データソースプラグイン** – このプラグインは によって提供され、 によってサポートされています AWS。
+ **エンタープライズプラグイン** – エンタープライズプラグインは AWS と Grafana Labs の両方でサポートされています。どちらのサポートチームでも問題を送信できます。
+ **コアプラグイン** – AWS または Grafana Labs が提供するコアプラグインおよびその他のプラグインは、 によって Amazon Managed Grafana でサポートされています AWS。GitHub でバグ修正や機能強化の問題を送信したり、 AWS または Grafana Labs でチケットを作成したりできます。
+ **コミュニティプラグイン** – AWS または Grafana Labs によって作成されていないコミュニティプラグインは通常、GitHub の問題やその他のフォーラムを通じてサポートされます。このような場合のサポート情報は、プラグインカタログのプラグインの詳細情報に含まれています。

[Amazon Managed Grafana](https://github.com/aws/amazon-managed-grafana-roadmap/issues) または [Grafana](https://github.com/grafana/grafana/issues) の GitHub フォーラムを通じてプラグインの問題を送信することもできます。

**プラグインバージョン**

ほとんどのプラグインは定期的に更新されます。Amazon Managed Grafana ワークスペースのプラグインカタログにはプラグインの最新バージョンが表示され、インストールするバージョンを選択できます。プラグインに既知のセキュリティ問題が残された古いバージョンがある場合、その古いバージョンは利用できません。

インストール済みのプラグインを[更新](#update-plugin)することもできます。

**注記**  
インストール済みのプラグインのセキュリティ問題が修正された、新しいバージョンのプラグインが使用可能になる場合があります。重大な問題の場合、Amazon Managed Grafana がワークスペースのプラグインを修正済みバージョンに自動更新する場合があります。

## プラグインカタログによるプラグインの管理
<a name="manage-plugins"></a>

Amazon Managed Grafana ワークスペースのプラグインはプラグインカタログから管理します。ワークスペース内のプラグインカタログに一覧表示されているプラグインのみをインストールできます。

以下に、プラグインカタログを使用するための前提条件と、プラグインカタログの検索方法について説明します。

**前提条件**
+ バージョン 9 をサポートする [Amazon Managed Grafana ワークスペース](AMG-create-workspace.md)、およびそのワークスペースにログインできるアカウントが必要です。
+ ワークスペースでは[プラグイン管理を有効にする](AMG-configure-workspace.md)ことが必要です。
+ ユーザーアカウントは [Amazon Managed Grafana ワークスペースの管理者](Grafana-user-roles.md)である必要があります。
+ エンタープライズプラグインをインストールして使用するには、まず [エンタープライズライセンスにアップグレード](AMG-workspace-manage-enterprise.md)する必要があります。

**プラグインカタログの表示方法**

1. Amazon Managed Grafana ワークスペースにサインインします。

1. 左側のメニューから、**[管理]**、**[プラグイン]** の順に選択します。プラグインカタログが開きます。

1. デフォルトでは、プラグインカタログにはインストール済みのプラグインが一覧表示されます。使用可能なすべてのプラグインを表示するには、カタログの上部にある **[状態]** フィルターで **[すべて]** を選択します。インストールされたプラグインには **[インストール済み]** というタグが含まれます。

## プラグインのインストールまたは削除
<a name="install-plugin"></a>

**注記**  
以前のセクションの前提条件を満たす必要があります。そうしないとプラグインを変更するアクセス許可を得られません。

**Grafana プラグインのインストールまたは削除方法**

1. プラグインカタログに移動します。

1. デフォルトでは、プラグインカタログにはインストール済みのプラグインのみが一覧表示されます。使用可能なすべてのプラグインを表示するには、カタログの上部にある **[状態]** フィルターで **[すべて]** を選択します。インストールされたプラグインには **[インストール済み]** というタグが含まれます。

1. インストールまたはアンインストールするプラグインを選択します。例えば、*Datadog* データソースを削除する場合は、**[Datadog]** プラグインを選択します。

1. プラグインの詳細ページで、アンインストールまたはインストールのオプションを選択します。

1. プラグインのインストール後、ワークスペースのすべての部分で変更が同期されるまでに最大で数分かかることがあります。新しいプラグインを使用する前に、数分待つことをお勧めします。

**注記**  
ワークスペースには (デフォルトのコアプラグインを超える) 50 個のプラグインをインストールできます。

## プラグインの更新
<a name="update-plugin"></a>

**既存の Grafana プラグインの更新方法**

1. Amazon Managed Grafana ワークスペースにサインインします。

1. 左側のメニューから、**[管理]**、**[プラグイン]** の順に選択します。プラグインカタログが開き、インストール済みのプラグインのみが一覧表示されます。

1. 更新するプラグインを選択します。

1. プラグインの詳細ページで、利用可能な更新があるかどうかを確認します。ある場合は、プラグインを更新するオプションを選択して更新するバージョンを選択します。
**注記**  
プラグインを変更するためのアクセス許可がないという注記が表示された場合は、ワークスペースで[プラグイン管理が有効になって](AMG-configure-workspace.md)いることを確認します。また、Amazon Managed Grafana ワークスペースの[管理者](Grafana-user-roles.md)である必要もあります。