次の方法で共有

Azure Managed Grafana でサービス アカウントを使用する方法

  • [アーティクル]

このガイドでは、サービス アカウントを使う方法について説明します。 サービス アカウントは、自動化された操作を実行する場合、Grafana API を使って Grafana でアプリケーションを認証する場合に使われます。

一般的な使用用途は次のとおりです。

  • ダッシュボードをプロビジョニングまたは構成する
  • レポートをスケジュールする
  • アラートを定義する
  • 外部 SAML 認証プロバイダーを設定する
  • ユーザーとしてサインインせずに Grafana と対話する

前提条件

サービス アカウントを有効にする

既存の Grafana ワークスペースでサービス アカウントが有効になっていない場合は、Azure portal または Azure CLI を使用して Grafana インスタンスの基本設定を更新することでサービス アカウントを有効にします。

  1. Azure portal の [設定] で [構成] を選び、次に [API keys and service accounts] (API キーとサービス アカウント) で [有効にする] を選びます。

    Azure プラットフォームのスクリーンショット。サービス アカウントを有効にする。

  2. [保存] を選び、Azure Managed Grafana で API キーとサービス アカウントを有効にすることを確定します。

サービス アカウントの作成

以下の手順に従って新しい Grafana サービス アカウントを作成し、既存のサービス アカウントを一覧表示します。

  1. Grafana インスタンスのエンドポイントに移動し、左側のメニューから [Users and access]>[Service accounts] を選択し、[Add service account] を選択します。

    Grafana のスクリーンショット。[サービス アカウントの追加] ページ。

  2. 新しい Grafana サービス アカウントの [Display name] と [Role] (オプションは、[No basic role]、[Viewer]、[Editor]、[Admin]) を入力し、[Create] を選択します。 既定では、ロールは割り当てられていません。

  3. サービス アカウントが作成されると、Grafana には、作成日、既存のトークン、それに関連付けられたアクセス許可など、新しいサービス アカウントに関する情報が表示されます。 次の手順で最初のトークンを作成します。

  4. 必要に応じて、左側のメニューから [Service accounts] を選択して、Grafana インスタンス内のすべてのサービス アカウントの一覧を表示します。

サービス アカウント トークンを追加する

サービス アカウントを作成したら、1 つ以上のアクセス トークンを追加します。 アクセス トークンは、ユーザー名とパスワードを使用せずに Grafana API で認証するために使用される、生成された文字列です。 各トークンは特定のアクセス許可に関連付けられているため、さまざまなユーザーまたはアプリケーションに付与されるアクセス レベルを制御できます。 トークンは、必要に応じて作成し、管理し、取り消すことができます。

Grafana UI で次の操作を行います。

  1. サービス アカウント トークンを作成するには、[Add service account token] を選択します。

  2. 自動的に生成された [Display name] を使用するか、任意の名前を入力します。 既定では、有効期限は作成日の 1 日後に設定されます。 必要に応じて、提案された [Expiration date] を更新するか、[No expiration] を選択します。

    Azure プラットフォームのスクリーンショット。[サービス アカウント トークンの追加] ページ。

  3. [Generate token](トークンの生成) を選択します。 トークンは一度だけ表示されるため、必ずコピーして安全に保存してください。 このトークンを失った場合は、新規に生成する必要があります。

  4. これで、トークンがサービス アカウントの詳細に一覧表示されます。

サービス アカウントを編集する

このセクションでは、Grafana サービス アカウントを更新する方法について説明します。

アクション:

  • 名前を編集するには、サービス アカウントを選び、[情報] で [編集] を選びます。
  • ロールを編集するには、サービス アカウントを選び、[情報] でロールを選び、別のロール名を選びます。
  • サービス アカウントを無効にするには、サービス アカウントを選び、ページの上部にある [サービス アカウントを無効にする] を選んでから [サービス アカウントを無効にする] を選んで確定します。 無効になったサービス アカウントは、[サービス アカウントを有効にする] を選んで再び有効にすることができます。

Azure プラットフォームのスクリーンショット。[サービス アカウントの編集] ページ。

"Service account updated" (サービス アカウントが更新されました) という通知がすぐに表示されます。

サービス アカウントを削除する

Grafana サービス アカウントを削除にするには、サービス アカウントを選び、ページの上部にある [サービス アカウントの削除] を選んでから [サービス アカウントの削除] を選んで確定します。 サービス アカウントの削除は最終的なものであり、削除後にサービス アカウントを復旧することはできません。

サービス アカウント トークンを削除する

サービス アカウント トークンを削除するには、サービス アカウントを選び、[トークン] で [削除 (x)] を選びます。 [削除] を選択して確定します。

Azure プラットフォームのスクリーンショット。[サービス アカウント トークンの削除] ページ。

次のステップ

この攻略ガイドでは、Azure Managed Grafana で自動操作を実行するためのサービス アカウントとトークンの作成および管理方法を学習しました。 準備ができたら、その他の記事を参照してください。

ゾーン冗長性を有効にする