ステージグループ用ダッシュボード

私たちはGitLab.comを監視するために使っているメトリクスへのWindowsとして機能するダッシュボードをたくさん生成しています。私たちのダッシュボードのほとんどは、runbooksリポジトリにあるJsonnetから生成されています。誰でもこれらに貢献することができ、新しいダッシュボードを追加したり、既存のものを修正したりすることができます。

ステージグループに新しいダッシュボードを追加する場合、stage_group:<group name> タグを付けると、同じタグを持つ他のダッシュボードにダッシュボードがクロスリンクされます。ステージグループ用のダッシュボードは、dashboards/stage-groups ディレクトリに作成できます。ディレクトリは 1 レベル以上ネストできません。

ステージグループのすべてのダッシュボードのリストを表示するには、次の手順に従います:

  1. Grafana で、ダッシュボードブラウザに移動します。
  2. 特定のグループのすべてのダッシュボードを表示するには、stage_group:<group name> でフィルタリングします。

生成されたダッシュボードの一部はすでに利用可能です:

  1. ステージグループダッシュボード:グループごとのメトリクスをカスタマイズできるダッシュボード。
  2. エラー予算詳細ダッシュボード:複数のSLIにわたるエラー予算の支出を経時的に調査できるダッシュボード。

時間範囲コントロール

Default time filter

デフォルトでは、すべての時間はUTCタイムゾーンです。エンジニアリングで通信する場合はUTCを使用します。

GitLabのプロダクションシステムに記録されたメトリクスは全て1年間保持されます。

グラフ上で直接、時間範囲を拡大したりフィルタリングしたりすることもできます。詳しくはGrafana Time Range Controlsのドキュメントをご覧ください。

フィルターとアノテーション

各ダッシュボードでは、ページの上部に2つのフィルターといくつかの注釈スイッチがあります。

いくつかの特別なイベントは、開発やオペレーション活動にとって意味のあるものです。Grafana のアノテーションは、グラフ上に直接それらをマークします。

Filters and annotations

名前種類説明
PROMETHEUS_DSフィルタ Prometheus データソースを選択的にフィルタリングします。デフォルト値はGlobal で、利用可能なすべてのデータソースからのデータを集約します。ほとんどの場合、このフィルタを気にする必要はありません。
environmentフィルタメトリクスが取得される環境をフィルタします。既定の設定は、production (gprd) です。その他のオプションについては、プロダクション環境のマッピングを参照してください。
stageフィルタステージによるメトリクスのフィルタリング:main またはcny for canary。デフォルトはmain
deployアノテーションGitLab.com SaaSプラットフォームのデプロイイベントをマークします。
canary-deployアノテーションGitLab.com SaaSプラットフォームのカナリアデプロイイベントをマークします。
feature-flagsアノテーション機能フラグが更新された時点をマークします。

ダッシュボードパネルに表示される機能フラグ注釈の例:

Annotations