Oracle Cloud Infrastructureドキュメント

Grafanaプラグイン

このトピックでは、GrafanaのOracle Cloud Infrastructureデータ・ソースをインストール、構成、および使用する手順について説明します。それ以外の場合は、Grafanaプラグインとして参照されます。

Grafanaプラグインの概要

Grafanaは、時系列データ(メトリック)のアナリティクスおよびモニタリングに使用できるオープン・ソース視覚化およびアラート・ツールです。 Oracle Cloud Infrastructure モニタリングからのメトリックは、メトリック・チャートでコンソールを介して表示できますが、Grafana ("Grafanaプラグイン")のOracle Cloud Infrastructureデータ・ソースを使用して、単一のGrafanaダッシュボードの複数のプロバイダからリソースのメトリックを表示できます。

Grafanaプラグインの使用の前提条件

  • Oracle Cloud Infrastructureアカウント。
  • アカウント・コンパートメント内のリソースの操作に必要な権限を付与する、IAMポリシーを持つセキュリティ・グループ内のそのアカウントのユーザー。 ポリシーでは、メトリック(Compute)を生成しているメトリック・ネームスペース(コンピュート・インスタンスのセットなど)および関連リソース(あるコンピュート・インスタンスのセットなど)にアクセスできる必要があります。 アクションを実行しようとしたときに、権限のないメッセージや権限のないメッセージを取得する場合は、管理者に付与されているアクセスのタイプと作業するコンパートメントを確認してください。 管理者: メトリックへのグループ・アクセス権を付与する共通ポリシーについては、「ユーザーにコンパートメント内のメトリック定義を表示させる」および「特定のメトリック・ネームスペースへのユーザー・アクセスを制限」を参照してください。 インスタンスなどのリソースを認可するには、APIコールを作成するために、一致ルールを使用して「動的グループ」にリソースを追加し、次にその動的グループがメトリックにアクセスできるポリシーを作成します。 コンパートメント間のアクセスを許可するには、テナンシ内にポリシーを作成します。 ポリシー継承の概念上、指定された動的グループ内のインスタンスは、コンパートメント内のメトリックにアクセスできるようになります。 特定のコンパートメントへのアクセスの範囲を狭めるには、そのコンパートメントをテナンシの代わりに指定します。 「インスタンスがAPIコールを行ってテナンシ内のモニタリング・メトリックにアクセスできるようにします」も参照してください。
  • コンピュート・インスタンス: コンピュート・メトリックを送信するには、インスタンスがモニター可能である必要があります。 OracleCloudAgentソフトウェアのインストールが必要な場合もあります。 詳細は、「コンピュート・インスタンスに対するモニタリングの有効化」を参照してください。
  • 必須キーとOracle Cloud Infrastructure ID (OCID)。 ガイダンスについては、「必要なキーとOCID」を参照してください。

Grafanaプラグインのダウンロードおよびインストール

この項では、Grafanaプラグインをローカル(LinuxまたはMac)あるいはTerraformスクリプトでダウンロードしてインストールする方法について説明します。 Oracle Cloud Infrastructure内でGrafanaを実行するコンピュート・インスタンスをプロビジョニングするには、Terraformスクリプトを使用します。

メトリック・アクセスの認証は、Grafanaの実行場所に依存します。 Oracle Cloud Infrastructureの外側のローカル・マシンでGrafanaを実行している場合は、「コマンド・ライン・インタフェース(CLI)」を使用してモニタリング APIを呼び出す必要があります。 Terraformスクリプトによって作成された新しいコンピュート・インスタンス上でGrafanaを実行している場合は、スクリプトで生成された動的グループを使用します。 作成したOracle Cloud Infrastructure コンピュート・インスタンス上でGrafanaを実行している場合、一致ルールを構成することによって、「動的グループ」にインスタンスを追加できます。 すべてのシナリオで、CLIを使用してAPIをコールするオプションがあります。

ローカル: プラグインのダウンロードおよびインストール

Grafanaプラグイン(Oracle Cloud Infrastructureデータソース(Grafana)をインストールするには、https://grafana.com/plugins/oci-datasource/installationを参照してください。 インストール後、Grafanaプラグインを構成できます。

Terraformスクリプト: Grafana環境の作成

この項では、Terraformスクリプトを使用して、仮想マシン上にGrafana環境を作成する方法について説明します。

Terraformスクリプトは、指定した名前を使用して動的グループを作成し、"grafana_policy"という名前のIAMポリシーを構成し、"TFInstance0"という名前のコンピュート・インスタンスを(コンパートメントとVCNで)プロビジョニングし、GrafanaとGrafanaプラグインの両方をインスタンスにダウンロードしてインストールします。

Terraformスクリプトの前提条件
Terraformスクリプトをダウンロードして実行するには

Grafanaプラグインの構成

この項では、Grafanaプラグインの追加方法とダッシュボードの設定方法について説明します。

Grafanaプラグインを構成するには

プラグインのトラブルシューティング

ダッシュボード問合せ(メトリック)にオプションの移入に失敗した場合、またはメトリックへのアクセスにその他の問題がある場合は、メトリックのアクセスに使用されるIAMポリシーの形式が不正であるか、または動的グループ(Terraform)スクリプトに必要な一致ルールがすべて含まれていない可能性があります。

この問題を解決するには、次を実行します。

  • IAMポリシーを確認し、前提条件が一致していることを確認してください。
  • Terraformの場合は、次の一致ルールを動的グループに追加することを検討してください:

    matching_rule = "ANY {instance.compartment.id = '${var.compartment_ocid}'}"

  • IAMポリシーを更新した場合は、Grafanaサーバーを再起動し、Grafanaホームページをリフレッシュします。

Terraform: 環境の削除

Terraformスクリプトを実行して仮想マシンにGrafana環境を作成している場合は、作業の完了後に環境を削除できます。 この項の指示に従って操作を実行します。

Grafana環境を削除するには