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

# プラグインを使用したワークスペースの拡張
<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)である必要もあります。

# AWS データソースプラグインを使用して AWS データを検索する
<a name="aws-datasources-plugin"></a>

AWS には、Amazon Managed Grafana ワークスペースのデータソースとして リソースを簡単に検出して使用できる AWS アプリケーションプラグインが用意されています。*AWS [データソース]* プラグインは、新しいワークスペースにデフォルトでインストールされます。

 AWS データソースプラグインには、検出のために リソースにアクセスするためのアクセス許可が必要です。詳細については、「[必要なアクセス許可](#aws-ds-plugin-permissions)」を参照してください。

## AWS データソースプラグインを開く
<a name="aws-ds-plugin-open"></a>

**AWS データソースプラグインを開くには**

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

1. 左上の**メニュー**から、[**アプリ**]、[**AWS データソース**] の順に選択します。

 AWS データソースプラグインインターフェイスには、リソースを検索できる AWS サービスが一覧表示されます。

## リソースの検出
<a name="aws-ds-plugin-use"></a>

**からリソースを検出するには AWS アカウント**

1.  AWS データソースプラグインを開きます。

1.  AWS サービスのリストから、データソースとして使用するリソースを検索するものを選択します。この例では、**[Amazon Managed Service for Prometheus]** を選択します。選択すると、その**サービス**が選択され状態で**データソース**タブが開きます。

1. リソースを検索する AWS リージョンを選択します。例えば、`US East (N. Virginia)` を選択します。
**注記**  
リソースを検索するには、プラグインに、そのリージョン内のサービスにアクセスするための適切な[アクセス許可](#aws-ds-plugin-permissions)が必要です。

1. 一部のサービスは、1 つのリージョンに複数のリソースを持つことができます。リージョンに複数のリソースがある場合、 AWS データソースプラグインは選択できるリストを提供します。

   リソース (この例では Amazon Managed Service for Prometheus) のリストから、データソースとして使用するリソースを選択します。この例の場合、Amazon Managed Service for Prometheus ワークスペースを選択すると、そのリソースがデータソースとして設定されます。データソースは、Amazon Managed Grafana でダッシュボードまたはモニタリングで使用できる状態になります。

1. プロビジョニングしたサービスおよびリージョンのリソースは、ページの下部に表示されます。

   (任意) [**設定に移動**] を選択すると、そのデータソースの設定を表示および編集することができます。

**注記**  
 AWS データソースプラグインは、ワークスペースにインストールされている個々のデータソースプラグインによって異なります。例えば AWS X-Ray 機能を使用する場合、[プラグインカタログ](grafana-plugins.md#manage-plugins)から X-Ray データソースプラグインをインストールする必要があります。

## プラグインのバージョンと更新
<a name="aws-ds-plugin-versions"></a>

 AWS データソースプラグインは定期的に更新されます。新しいワークスペースにインストールされているバージョンは通常、最新バージョンではありません。新しいバージョンでは、ワークスペースにインストールされているバージョンよりも多くの機能を使用できます。たとえば、新しいバージョンでは、データソースとして追加の AWS サービスをサポートする場合があります。

 AWS データソースプラグインの各バージョンの変更を確認するには、[Changelog](https://grafana.com/grafana/plugins/aws-datasource-provisioner-app/?tab=changelog) を表示できます。

プラグインを新しいバージョンに更新するには、[プラグインの更新](grafana-plugins.md#update-plugin) の標準手順に従ってください。

**注記**  
データソース AWS プラグインの新しいバージョンに更新する場合は、Amazon Managed Grafana によって管理されていない新しいデータソースに追加の[アクセス許可](#aws-ds-plugin-permissions)を提供する必要があります。

## 必要なアクセス許可
<a name="aws-ds-plugin-permissions"></a>

 AWS データソースプラグインには、 AWS リソースにアクセスするためのアクセス許可が必要です。これを行う最も簡単な方法は、Amazon Managed Grafana がアクセス権限を管理できるようにすることです。データソースへの権限をサービス管理で行えるよう設定する方法については、「[データソースおよび通知チャネルのアクセス権管理](AMG-datasource-and-notification.md)」を参照してください。Amazon Managed Grafana は、デフォルトで AWS データソースプラグインに含まれる AWS リソースのアクセス許可を管理できます。

 AWS データソースプラグインをワークスペースにデフォルトで含まれているバージョンよりも新しいバージョンに更新すると、Amazon Managed Grafana によってアクセス許可が自動的に管理されない AWS リソースのサポートが追加される可能性があります。この場合、権限を自分で追加する必要があります。たとえば、 AWS IoT TwinMaker が最新バージョンのプラグイン (バージョン 1.9.0) に追加され、これらのアクセス許可は Amazon Managed Grafana によって管理されません。

特定のデータソースに対する権限の詳細については、 [データソースに接続する](AMG-data-sources.md) セクションで提供されているデータソースの詳細を参照してください。たとえば、 [An AWS IoT TwinMaker データソースに接続する](AMG-iot-twinmaker.md)セクションには、Amazon Managed Grafana に access AWS IoT TwinMaker へのアクセス許可を付与する方法の詳細が含まれています。