ステージグループ用ダッシュボード
私たちはGitLab.comを監視するために使っているメトリクスへのWindowsとして機能するダッシュボードをたくさん生成しています。私たちのダッシュボードのほとんどは、runbooksリポジトリにあるJsonnetから生成されています。誰でもこれらに貢献することができ、新しいダッシュボードを追加したり、既存のものを修正したりすることができます。
ステージグループに新しいダッシュボードを追加する場合、stage_group:<group name>
タグを付けると、同じタグを持つ他のダッシュボードにダッシュボードがクロスリンクされます。ステージグループ用のダッシュボードは、dashboards/stage-groups
ディレクトリに作成できます。ディレクトリは 1 レベル以上ネストできません。
ステージグループのすべてのダッシュボードのリストを表示するには、次の手順に従います:
- Grafana で、ダッシュボードブラウザに移動します。
- 特定のグループのすべてのダッシュボードを表示するには、
stage_group:<group name>
でフィルタリングします。
生成されたダッシュボードの一部はすでに利用可能です:
- ステージグループダッシュボード:グループごとのメトリクスをカスタマイズできるダッシュボード。
- エラー予算詳細ダッシュボード:複数のSLIにわたるエラー予算の支出を経時的に調査できるダッシュボード。
時間範囲コントロール
デフォルトでは、すべての時間はUTCタイムゾーンです。エンジニアリングで通信する場合はUTCを使用します。
GitLabのプロダクションシステムに記録されたメトリクスは全て1年間保持されます。
グラフ上で直接、時間範囲を拡大したりフィルタリングしたりすることもできます。詳しくはGrafana Time Range Controlsのドキュメントをご覧ください。
フィルターとアノテーション
各ダッシュボードでは、ページの上部に2つのフィルターといくつかの注釈スイッチがあります。
いくつかの特別なイベントは、開発やオペレーション活動にとって意味のあるものです。Grafana のアノテーションは、グラフ上に直接それらをマークします。
名前 | 種類 | 説明 |
---|---|---|
PROMETHEUS_DS | フィルタ |
Prometheus データソースを選択的にフィルタリングします。デフォルト値はGlobal で、利用可能なすべてのデータソースからのデータを集約します。ほとんどの場合、このフィルタを気にする必要はありません。 |
environment | フィルタ | メトリクスが取得される環境をフィルタします。既定の設定は、production (gprd ) です。その他のオプションについては、プロダクション環境のマッピングを参照してください。 |
stage | フィルタ | ステージによるメトリクスのフィルタリング:main またはcny for canary。デフォルトはmain
|
deploy | アノテーション | GitLab.com SaaSプラットフォームのデプロイイベントをマークします。 |
canary-deploy | アノテーション | GitLab.com SaaSプラットフォームのカナリアデプロイイベントをマークします。 |
feature-flags | アノテーション | 機能フラグが更新された時点をマークします。 |
ダッシュボードパネルに表示される機能フラグ注釈の例: