カスタム ダッシュボードを共有する

このドキュメントでは、 Google Cloud プロジェクトに含まれるカスタム ダッシュボードを組織内のユーザーやグループと共有する方法について説明します。たとえば、問題をトラブルシューティングするときに、チームメンバーにダッシュボードを閲覧してもらいたいことがあります。

可能であれば、Monitoring を使用してダッシュボードの URL を受信者に送信することをおすすめします。Monitoring は、ダッシュボードを表示する権限がない可能性のある受信者を特定し、必要な権限を付与するためのオプションを提供します。

実際のダッシュボードではなく、ダッシュボードの構造(定義)を共有することもできます。詳細については、ダッシュボードの定義を別のプロジェクトにコピーするをご覧ください。

この機能は Google Cloud プロジェクトでのみサポートされています。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

ベスト プラクティス

ダッシュボードを共有する際の権限の障壁をなくすため、 Google Cloud プロジェクトのオーナー(roles/ownerの IAM ロールを持つプリンシパルが、その Google Cloud プロジェクトに保存されているダッシュボードを表示する必要があるすべてのユーザー、グループ、またはドメインに Monitoring 閲覧者(roles/monitoring.viewerのロールを付与することをおすすめします。詳細については、Cloud Monitoring へのアクセス権を付与するをご覧ください。

始める前に

共有するダッシュボードを保存する Google Cloud プロジェクトで、次の操作を行います。

  1. Google Cloud コンソールで [IAM] ページに移動します。

    [IAM] に移動

    このページを検索バーで検索する場合は、小見出しが「IAM と管理」の結果を選択します。

  2. Google Cloud プロジェクトを選択します。

    権限拒否エラーが表示された場合は、プロジェクトに IAM ロールがないか、ロールがプロジェクト スコープでないか可能性があります。[IAM] ページを表示するには、プロジェクト スコープの IAM ロールが必要です。プロジェクト スコープのロールには、オーナー(roles/owner)、編集者(roles/editor)、閲覧者(roles/viewer)のロールがあります。

ダッシュボードを共有する

データ異常を調査するときに、別のユーザーまたはグループにもカスタム ダッシュボードが表示されるようにしたい場合があります。たとえば、パフォーマンス指標が急激に低下または上昇した場合は、チームのメンバーと相談する必要があります。このシナリオでは、ダッシュボードをチームメンバーと共有することを目的とします。

ダッシュボードを共有する手順は、次のとおりです。

  1. Google Cloud コンソールで [ ダッシュボード] ページに移動します。

    [ダッシュボード] に移動

    このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

  2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
  3. ダッシュボードを選択します。
  4. [ 共有] をクリックし、次の表を参考にしてダイアログを完成させます。

    オーナー(roles/owner

    1. [ユーザーやグループを追加] をクリックし、ユーザーまたはグループの名前を入力します。
    2. [メッセージ] をクリックして、メールに含める情報を入力します。ダッシュボードの URL を含める必要はありません。
    3. 省略可: 特定の期間のデータをダッシュボードに表示するには、[期間を指定してダッシュボードを開く] を選択し、開始時刻と終了時刻を入力します。

      デフォルトでは、ダッシュボードには直近 1 時間のデータが表示されます。

    4. [送信] をクリックします。

      Monitoring が、メールの受信者にダッシュボードを表示する権限があるかどうかを評価します。Monitoring はグループのメンバーにアクセスできないため、グループのメンバーはダッシュボードを表示する権限が必要だと認識される可能性があります。

      すべての受信者にダッシュボードを表示する権限がある場合、受信者にはダッシュボードの閲覧に招待するメールが送信されます。このメールには、メッセージとダッシュボードの URL が含まれています。

    5. ダイアログが開いて、受信者へのアクセス権を付与するように求められた場合、Monitoring は受信者にダッシュボードを表示する権限がない可能性があると判断します。

      ダッシュボードの表示に必要な最小限の権限を付与するには、モニタリング閲覧者のロールを選択して [送信] をクリックします。

      各受信者には、ダッシュボードの閲覧に招待するメールが送信されます。このメールには、メッセージとダッシュボードの URL が含まれています。

    編集者(roles/editor

    1. [ユーザーやグループを追加] をクリックし、ユーザーまたはグループの名前を入力します。
    2. [メッセージ] をクリックして、メールに含める情報を入力します。ダッシュボードの URL を含める必要はありません。
    3. 省略可: 特定の期間のデータをダッシュボードに表示するには、[期間を指定してダッシュボードを開く] を選択し、開始時刻と終了時刻を入力します。

      デフォルトでは、ダッシュボードには直近 1 時間のデータが表示されます。

    4. [送信] をクリックします。

      Monitoring が、メールの受信者にダッシュボードを表示する権限があるかどうかを評価します。Monitoring はグループのメンバーにアクセスできないため、グループのメンバーはダッシュボードを表示する権限が必要だと認識される可能性があります。

      すべての受信者にダッシュボードを表示する権限がある場合、受信者にはダッシュボードの閲覧に招待するメールが送信されます。このメールには、メッセージとダッシュボードの URL が含まれています。

    5. 「アクセス権がない受信者が含まれている可能性がある」というタイトルのダイアログが表示された場合、Monitoring は受信者にダッシュボードを表示する権限がない可能性があると判断します。共有コマンドを続行するには、[送信]、[OK] の順にクリックします。

      各受信者には、ダッシュボードの閲覧に招待するメールが送信されます。このメールには、メッセージとダッシュボードの URL が含まれています。

    閲覧者(roles/viewer

    1. [ユーザーやグループを追加] をクリックし、ユーザーまたはグループの名前を入力します。
    2. [メッセージ] をクリックして、メールに含める情報を入力します。ダッシュボードの URL を含める必要はありません。
    3. 省略可: 特定の期間のデータをダッシュボードに表示するには、[期間を指定してダッシュボードを開く] を選択し、開始時刻と終了時刻を入力します。

      デフォルトでは、ダッシュボードには直近 1 時間のデータが表示されます。

    4. [送信] をクリックします。

      Monitoring が、メールの受信者にダッシュボードを表示する権限があるかどうかを評価します。Monitoring はグループのメンバーにアクセスできないため、グループのメンバーはダッシュボードを表示する権限が必要だと認識される可能性があります。

      すべての受信者にダッシュボードを表示する権限がある場合、受信者にはダッシュボードの閲覧に招待するメールが送信されます。このメールには、メッセージとダッシュボードの URL が含まれています。

    5. 「アクセス権がない受信者が含まれている可能性がある」というタイトルのダイアログが表示された場合、Monitoring は受信者にダッシュボードを表示する権限がない可能性があると判断します。共有コマンドを続行するには、[送信]、[OK] の順にクリックします。

      各受信者には、ダッシュボードの閲覧に招待するメールが送信されます。このメールには、メッセージとダッシュボードの URL が含まれています。

    その他のすべてのロール

    1. [ユーザーやグループを追加] をクリックし、ユーザーまたはグループの名前を入力します。
    2. [メッセージ] をクリックして、メールに含める情報を入力します。ダッシュボードの URL を含める必要はありません。
    3. 省略可: 特定の期間のデータをダッシュボードに表示するには、[期間を指定してダッシュボードを開く] を選択し、開始時刻と終了時刻を入力します。

      デフォルトでは、ダッシュボードには直近 1 時間のデータが表示されます。

    4. [送信] をクリックします。

      Monitoring は、受信者にダッシュボードの閲覧を招待するメールを送信します。このメールには、メッセージとダッシュボードの URL が含まれています。

トラブルシューティング

このセクションでは、ダッシュボードの共有時に発生する可能性のあるエラーの解決方法について説明します。

ダッシュボードを共有する際にエラー メッセージが表示される

ダッシュボードを共有する際に、次の 2 つのエラーが発生することがあります。

  • オーナー(roles/owner)ロールを持っているにもかかわらず、共有ダイアログに次のエラー メッセージが表示されます。

    Unable to grant access to the following account due to organization configurations

    組織のポリシーにより、プリンシパルにロールを付与できません。このエラーを解決するには、組織管理者にお問い合わせください。

  • メールアドレスのない受信者を 1 つ以上選択した場合、共有ダイアログに次のエラー メッセージが表示されます。

    Error: Email addresses and domains must be associated with an active Google Account, Google Workspace account, or Cloud Identity account.

    ただし、有効なメールアドレスを持つすべての受信者にメール通知が送信されています。

共有ダッシュボードを表示できない

ダッシュボードの URL がメールで届きましたが、URL にアクセスしてもダッシュボードを表示できません。代わりに、次のメッセージが表示されます。

You do not have sufficient permissions to view this page

この状況を解決するには、プロジェクト オーナーに連絡して、モニタリング閲覧者(roles/monitoring.viewer)のロールを付与するよう依頼してください。

次のステップ