observability-manage-slos

サービスレベル目標（SLO）

Elastic Observability で SLO を作成、管理します。SLO は、Elasticsearch のデータから算出されるサービスレベル指標（SLI）を使用して、測定可能な目標に対するサービスのパフォーマンスを追跡します。

認証

SLO の操作には Kibana API を使用します。API キーまたは基本認証で認証します。

# API key
curl -H "Authorization: ApiKey <base64-encoded-key>" -H "kbn-xsrf: true" <KIBANA_URL>/api/observability/slos

# Basic auth
curl -u "$KIBANA_USER:$KIBANA_PASSWORD" -H "kbn-xsrf: true" <KIBANA_URL>/api/observability/slos

デフォルト以外のスペースでは、パスの先頭に /s/<space_id>/api/observability/slos を付けます。

すべての POST、PUT、DELETE リクエストに kbn-xsrf: true を含めてください。

SLI の種類

種類	API 値	使用例
カスタム KQL	sli.kql.custom	生ログ — KQL クエリを使用した正常数／合計数
カスタムメトリック	sli.metric.custom	メトリックフィールド — 集計を使用した数式
タイムスライスメトリック	sli.metric.timeslice	メトリックフィールド — スライスごとのしきい値チェック
ヒストグラムメトリック	sli.histogram.custom	ヒストグラムフィールド — range／value_count
APM レイテンシー	sli.apm.transactionDuration	APM — レイテンシーのしきい値
APM 可用性	sli.apm.transactionErrorRate	APM — 成功率
Synthetics 可用性	sli.synthetics.availability	Synthetics モニター — 稼働率

ガイドライン

• objective.target は 0 から 1 までの小数です（たとえば、99.5% の場合は 0.995）。
• タイムスライスメトリックのインジケーターには budgetingMethod: "timeslices" が必要です。
• SLO を更新すると、基盤となる transform がリセットされます。過去のデータは再計算されます。
• クラスターには、transform と ingest の両方のロールを持つノードが必要です。
• SLO が停止した場合、またはインデックスのマッピングを変更した後は、POST .../slos/{id}/_reset を使用します。
• グループ化する SLO は一意の値ごとに 1 つのインスタンスを作成するため、カーディナリティの高いフィールドは避けてください。
• Synthetics SLO はモニターとロケーションごとに自動でグループ化されます。groupBy は手動で設定しないでください。
• バーンレートのアラートルールは API で自動作成されません。別途設定してください。

参考資料

公式ドキュメントについては、以下のリソースを参照してください。

SLO のドキュメント

• サービスレベル目標（SLO） — 概念、SLI の種類、予算設定方法、ダッシュボードパネルについて説明しています。
• SLO を作成する — Kibana UI で SLO を作成する手順を説明しています。
• SLO の表示と管理 — 既存の SLO の検索、フィルタリング、管理について説明しています。

Kibana SLO API

• SLO を作成する — すべての SLI タイプのペイロードを含む、完全なリクエストボディのスキーマです。
• SLO を取得する | 更新 | 削除 | リセット
• 有効化 | 無効化 | 定義を取得

トラブルシューティングとアクセス

• SLO のトラブルシューティング
• SLO アクセスの設定
• SLO バーンレートルールの作成