すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Service Mesh:SLO CRD field reference

    ドキュメントセンター

    Alibaba Cloud Service Mesh:SLO CRD field reference

    最終更新日:Mar 11, 2026

    Service Mesh (ASM) を使用すると、ServiceLevelObjective カスタムリソース定義 (CRD) を通じて、サービスレベル目的 (SLO) およびアラートルールを宣言的に定義できます。

    以下のフィールド リファレンスは、階層によって整理されています：metadata > spec > slos[] > sli または alerting。

    YAML の例

    以下のマニフェストでは、default 名前空間の httpbin サービスに対する可用性 SLO を定義します。目標は 99.9% で、この SLO は 30 日間の期間にわたって適用され、ページレベルとチケットレベルの両方のアラートが設定されています。

    apiVersion: istio.alibabacloud.com/v1beta1
kind: ServiceLevelObjective
metadata:
  name: asm-slo-default-httpbin          # Format: asm-slo-{namespace}-{service}
  namespace: default                      # Must match the target service namespace
spec:
  service: httpbin                        # Target service name
  period: 30d                             # Period of time during which the SLO takes effect: 30d, 28d, 14d, or 7d
  labels:
    owner: "finance-team"                 # Global label, propagated to all generated recording rules
  slos:
  - name: asm-slo2                        # Unique SLO name within this CRD
    objective: "99.9"                     # Target percentage as a string
    labels:
      description: "service availability description"
    sli:
      plugin:
        id: availability                  # Plugin type: availability or latency
        options:                          # Plugin-specific options
          filter: request_protocol="http" # PromQL label filter
    alerting:
      name: asm-alert                     # Alert rule name
      labels:
        category: "availability"
      annotations:
        summary: "High error rate on requests"
      pageAlert:                          # High-severity, page-level alert
        labels:
          severity: "10"
      ticketAlert:                        # Low-severity, ticket-level alert
        labels:
          channel: "channel - call"

    以下の表は、主要なフィールドをまとめたものです。フィールドの詳細については、「CRD フィールドリファレンス」をご参照ください。

    フィールド説明
    namespaceカスタムリソースの名前空間。ターゲットサービスの名前空間と一致する必要があります。
    serviceターゲットサービス名。
    periodSLO が有効になる期間。有効な値: 30d、28d、14d、または 7d。
    objective文字列としての目標パーセンテージ。有効範囲: (0, 100]。
    pluginSLI タイプとオプションを定義します。id を availability または latency に設定し、対応するオプションを構成します。「プラグインフィールド」をご参照ください。

    CRD フィールドリファレンス

    metadata フィールド

    フィールドタイプ必須説明例
    nameStringはいカスタムリソース名。形式：asm-slo-{namespace}-{service}。asm-slo-default-httpbin
    namespaceStringはいカスタムリソースの名前空間。ターゲットサービスの名前空間と一致する必要があります。default
    labelsObjectいいえバックエンドによって自動入力されます。手動で設定しないでください。システムは 2 つのラベルを追加します。asm-target-namespace (サービスの名前空間) と asm-target-service (サービス名。spec.service と同じ) です。labels:
    asm-target-namespace: default
    asm-target-service: httpbin




    spec フィールド

    フィールドタイプ必須説明例
    serviceStringはいターゲットサービス名。httpbin
    periodStringはいSLO が有効になる期間。有効な値: 30d (30 日)、28d、14d、7d。30d
    labelsObjectいいえグローバルラベル。この CRD 内の SLO によって生成されるすべての記録ルールの labels フィールドに伝播されます。labels:
    global: "some-label"

    slosArrayはい1 つ以上の SLO 定義。少なくとも 1 つのエントリが必要です。-

    slos[] フィールド

    slos 配列の各エントリは、その目標、SLI 構成、およびアラート機能ルールを持つ単一の SLO を定義します。

    フィールドタイプ必須説明例
    nameStringはいSLO 名。asm-slo
    objectiveStringはい浮動小数点数として解析可能な文字列としての目標パーセンテージ。有効範囲: (0, 100]。"99.9"
    labelsObjectいいえSLO レベルのラベル。この SLO によって生成されるすべての記録ルールの labels フィールドに伝播されます。labels:
    recordlabel: aaa

    sliObjectはいサービスレベル指標 (SLI) 構成。「sli フィールド」をご参照ください。-
    alertingObjectはいアラートルール構成。「alerting フィールド」をご参照ください。-

    sli フィールド

    sli オブジェクトには、単一のフィールド plugin が含まれます。

    フィールドタイプ必須説明例
    pluginObjectはいSLI がどのように測定されるかを定義するプラグイン構成。「プラグインフィールド」をご参照ください。-

    プラグインフィールド

    プラグインは SLI 測定タイプを決定します。プラグインを選択するには id を設定し、対応する options を構成します。

    フィールドタイプ必須説明例
    idStringはいプラグインタイプ。有効な値: availability (サービス可用性)、latency (サービスレイテンシー)。latency
    optionsMap条件付きプラグインオプション。選択したプラグインに必須フィールドがある場合に必要です。たとえば、latency には bucket が必要です。以下のオプションテーブルをご参照ください。options:
    bucket: "300"

    availability のオプション

    id が availability に設定されている場合、以下のオプションが利用可能です。

    フィールドタイプ必須説明例
    filterStringいいえPromQL ラベルフィルター。Prometheus は、このフィルターに一致するリクエストに対してのみメトリックを計算します。request_protocol="http"

    latency のオプション

    id が latency に設定されている場合、以下のオプションが利用可能です。

    フィールドタイプ必須説明例
    bucketStringはい整数として解析可能な文字列としてのレイテンシー目標。"300"
    filterStringいいえPromQL ラベルフィルター。Prometheus は、このフィルターに一致するリクエストに対してのみメトリックを計算します。request_protocol="http"
    exclude_errorsBooleanいいえレイテンシー計算からエラーリクエストを除外するかどうか。デフォルト：false。true の場合、5XX 応答コードを持つリクエストは除外されます。false の場合、すべてのリクエストが含まれます。false

    alerting フィールド

    フィールドタイプ必須説明例
    nameStringはいアラートルール名。asm-alert
    labelsMapいいえアラートルールにアタッチされたラベル。labels:
    alertlabel: bbb

    annotationsMapいいえアラートルールにアタッチされたアノテーション。annotations:
    alertanno: ccc

    pageAlertObjectいいえページレベルの高重大度アラート構成。「pageAlert フィールド」をご参照ください。-
    ticketAlertObjectいいえチケットレベルの低重大度アラート構成。「ticketAlert フィールド」をご参照ください。-

    pageAlert フィールド

    フィールドタイプ必須説明例
    disableBooleanいいえこのアラートを有効にするかどうか。デフォルト：true (有効)。無効にするには false に設定します。false
    labelsMapいいえこのアラートにアタッチされたラベル。labels:
    pagelabel: ddd

    annotationsMapいいえこのアラートにアタッチされたアノテーション。annotations:
    pageanno: eee

    ticketAlert フィールド

    フィールドタイプ必須説明例
    disableBooleanいいえこのアラートを有効にするかどうか。デフォルト：true (有効)。無効にするには false に設定します。false
    labelsMapいいえこのアラートにアタッチされたラベル。labels:
    pagelabel: ddd

    annotationsMapいいえこのアラートにアタッチされたアノテーション。annotations:
    pageanno: eee