Grafana Cloud

Grafana Cloudを接続すると、エージェントがダッシュボードを読み、データソースを問い合わせ、Grafanaのアラートを調べられるようになります。

セットアップ

1. Grafana Cloudポータルで、**https://yourstack.grafana.net**のようなスタックURLを確認します。
2. GrafanaスタックでAdministration → Users and access → Service accountsを開きます。
3. Editorロールを持つサービスアカウントを作成します。Editorは、エージェントがダッシュボードを読み、データソースを問い合わせ、アノテーションを作成することを許し、PolylaneがGrafanaのアラートを購読できるようにします。
4. サービスアカウントにトークンを追加し、両方の値をPolylaneに貼り付けます。Polylaneがスタックに対してそれらを検証し、接続します。

トークンは保存前に暗号化され、エージェントが目にすることはありません。

Grafana Cloudの無料ティアのスタックは、非アクティブになると休止します。検証でスタックに到達できないと報告された場合は、ブラウザーで一度開いてから再試行してください。

アラートと継続的な監視

接続時に、Polylaneはスタック内にWebhookのコンタクトポイントをプロビジョニングし、通知ポリシーツリーにキャッチオールのルートを追加します。このルートはすべてのアラートに一致し、既存のルートへ処理を続けるため、現在の配信には影響せず、後で作成したアラートルールも自動的にPolylaneに通知します。発火したアラートはワークスペースに届き、トリアージされ、調査を開始できます。

Polylaneはまた、すべてのダッシュボードを読み、各パネルのクエリを異常チェックとして継続的に実行し、ダッシュボードが見逃しているシグナルのためのキークエリを発見します。

エージェントができること

• ダッシュボードを検索し、そのパネル定義とクエリを読む
• データソースを一覧し、ヘルスチェックを実行する
• Grafanaのクエリプロキシを通じてPromQL、LogQL、TraceQL、その他データソース固有のクエリを実行する
• アラートルール、そのライブの状態と健全性、そしていま発火しているアラートを調べる
• チャートのアノテーションを読み、デプロイやインシデントの期間のために新しいアノテーションを作成する

接続解除

PolylaneでGrafana Cloudを接続解除します。プロビジョニングしたコンタクトポイントと通知ポリシーのルートが取り除かれます。次にGrafanaでサービスアカウントのトークンを削除します。ルートがTerraformにある場合は、同時に削除してください。

1時間ごとの調整処理が、polylaneコンタクトポイントとそのキャッチオールのポリシールートを維持します。grafana_notification_policyリソースはポリシーツリー全体を管理するため、ルートを省いたTerraform applyはそれを取り除き、調整処理が再び追加します。ルートをツリーの最初のポリシーとして、自分のルートが引き続きすべてを受け取れるようにcontinue = trueを付けて保持し、コンタクトポイント自体はPolylaneに任せてください。

resource "grafana_notification_policy" "tree" {
  # ...

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

アラートルールにはルールごとのセットアップは不要です。このルートはすべてのアラートに一致します。インテグレーションを接続解除するとコンタクトポイントとルートが取り除かれるため、同時にTerraform設定からルートを削除してください。