サービスチェックは、特定のサービスがアップ状態かダウン状態かを監視します。指定された回数連続して監視 Agent がサービスに接続できない場合、アラートが発生します。Check Status ウィジェットにより、ダッシュボード上でサービスの劣化、サービス障害、クラスター全体の問題、スループットの低下、レイテンシーの増加を視覚的に表示できます。詳細については、サービスチェックのドキュメントを参照してください。
チェックステータスは、実行されたチェックの現在のステータスまたは結果の数を表示します。
セットアップ
構成
以前に作成したサービスチェックを選択します。
レポートの時間枠を選択します。この時間枠には常に現在までが含まれるため、The past 10 minutes
(過去 10 分) や The past 1 day
(過去 1 日) などのオプションを選択すると、現在までの時間枠を含むステータスが報告されます。Global Time
を選択すると、ダッシュボードを使用する人は右上の時間枠セレクターを使用して範囲を選択できますが、現在の瞬間を含むものを選択する必要があります。つまり past X
(過去X) の時間枠です。それ以外の場合、ウィジェットは空白になります。
スコープを選択します。
- A single check: チェックステータスウィジェットが特定の要素 (例: 1 つの
host:<HOSTNAME>
、1 つの service:<SERVICE_NAME>
) のみを対象とする場合は、このオプションを選択します。 - A cluster of checks: チェックステータスウィジェットが一定の範囲の要素 (すべての
host
、すべての service
) を対象とする場合は、このオプションを選択します。
スコープを選択したら、Reported by フィールドで、チェックステータスウィジェットのコンテキストを定義します。
A Cluster of checks スコープで、Group by フィールドを使用してサブセットを選択するオプションがあります。注: チェックステータスは、グループごとのチェック数を表示するのではなく、チェックを実行しているグループの数を表示します。例えば、Agent Up を env
でグループ化して監視している場合、チェックステータスは、環境内の Agent の数ではなく、スコープ構成に一致し、Agent を実行している env
の数を表示します。
API
このウィジェットは Dashboards API で使用できます。ウィジェット JSON スキーマ定義については、以下の表を参照してください。
Expand All
Name of the check to use in the widget.
Group reporting a single check.
List of tag prefixes to group by in the case of a cluster check.
The kind of grouping to use.
Allowed enum values: check,cluster
List of tags used to filter the groups reporting a cluster check.
Time setting for the widget.
The available timeframes depend on the widget you are using.
Allowed enum values: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1w,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert
Used for arbitrary live span times, such as 17 minutes or 6 hours.
Type "live" denotes a live span in the new format.
Allowed enum values: live
Unit of the time span.
Allowed enum values: minute,hour,day,week,month,year
Used for fixed span times, such as 'March 1 to March 7'.
Start time in seconds since epoch.
End time in seconds since epoch.
Type "fixed" denotes a fixed span.
Allowed enum values: fixed
How to align the text on the widget.
Allowed enum values: center,left,right
Type of the check status widget.
Allowed enum values: check_status
default: check_status
{
"check": "",
"group": "string",
"group_by": [],
"grouping": "check",
"tags": [],
"time": {
"live_span": "5m"
},
"title": "string",
"title_align": "string",
"title_size": "string",
"type": "check_status"
}
その他の参考資料