サービスレベル目標 API

API キーを取得するには、以下の手順を完了してください：

1. Instana UI にサインイン
2. ナビゲーションサイドバーから、 [設定 ] > [セキュリティとアクセス] タブに移動します。 アクセス制御で、 [ API トークン] を選択し、[ 新しい API トークン ] をクリックします。
3. 必須項目を入力し、必要な権限を有効にしてください。
4. 保存 をクリックします。

以下のSLOは、平均遅延が341ミリ秒未満であることを示す 96.3818 %のサービス品質を目標としています。エラー予算は、7日間のローリング時間窓において分単位で計算されます。 これはバックエンドアプリケーションの観点から測定されています。 このSLOはデフォルトでタイム UTC ゾーンに紐付けられています。

ペイロード:

{
  "name": "Cupcake Vending Machine performance aggregation over time",
  "target": 0.963818,
  "lastUpdated": 1690357470848,
  "entity": {
    "type": "application",
    "applicationId": "LsEOORPeR0Gnt_kntZbosw",
    "serviceId": null,
    "endpointId": null,
    "boundaryScope": "ALL",
    "includeInternal": false,
    "includeSynthetic": false,
    "tagFilterExpression": null
  },
  "indicator": {
    "type": "timeBased",
    "blueprint": "latency",
    "threshold": 341,
    "aggregation": "MEAN"
  },
  "timeWindow": {
    "type": "rolling",
    "duration": 7,
    "durationUnit": "day"
  },
  "tags": [
    "food",
    "snacks",
    "timeBased",
    "latency",
    "demo"
  ]
}
 

以下のSLOは、合成テスト結果における非誤り結果と誤り結果の比率から算出される、 96.99 %のサービス品質を目標としています。 エラー予算は、7日間のローリング時間ウィンドウにおける個々のイベントに基づいて計算されます。 これはバックエンドアプリケーションの観点から測定されています。 デフォルトでは、このSLOはタイム UTC ゾーンに準拠しています。

ペイロード:

    {
      "name": "Cupcake Shop Synthetic Availability",
      "target": 0.9699,
      "lastUpdated": 1742587582774,
      "entity": {
        "type": "synthetic",
        "syntheticTestIds": [
          "lLW0jCW8mZRmdrEZ1cno"
        ],
        "tagFilterExpression": {
          "type": "EXPRESSION",
          "logicalOperator": "AND",
          "elements": []
        }
      },
      "indicator": {
        "type": "eventBased",
        "threshold": 0,
        "operator": null,
        "aggregation": null,
        "badEventsFilter": {
          "type": "TAG_FILTER",
          "name": "call.erroneous",
          "stringValue": null,
          "numberValue": null,
          "booleanValue": true,
          "floatValue": null,
          "key": null,
          "value": null,
          "operator": "EQUALS",
          "entity": "NOT_APPLICABLE"
        },
        "goodEventsFilter": {
          "type": "TAG_FILTER",
          "name": "call.erroneous",
          "stringValue": null,
          "numberValue": null,
          "booleanValue": false,
          "floatValue": null,
          "key": null,
          "value": null,
          "operator": "EQUALS",
          "entity": "NOT_APPLICABLE"
        },
        "blueprint": "availability"
      },
      "timeWindow": {
        "type": "rolling",
        "duration": 1,
        "durationUnit": "week"
      },
      "tags": []
    }
 

以下のSLOは、合成テスト結果の総トラフィック数に基づき、90%のサービス品質を目標としています。 誤差予算は、1日という固定時間枠において分単位で計算される。 時間窓内の全トラフィックの合計から測定されています。 SLOはタイム Europe/Dublin ゾーンに紐付けられています。

ペイロード:

    {
      "name": "Cupcake Shop Synthetic Traffic",
      "target": 0.9,
      "lastUpdated": 1736873398635,
      "entity": {
        "type": "synthetic",
        "syntheticTestIds": [
          "zOj9zRK2142Fjo6SNc4r",
          "0Ir0TqQzEECdc05jiHHu"
        ],
        "tagFilterExpression": {
          "type": "EXPRESSION",
          "logicalOperator": "AND",
          "elements": []
        }
      },
      "indicator": {
        "threshold": 1,
        "operator": ">=",
        "aggregation": "SUM",
        "trafficType": "all",
        "type": "timeBased",
        "blueprint": "traffic"
      },
      "timeWindow": {
        "type": "fixed",
        "duration": 1,
        "durationUnit": "day",
        "timezone": "Europe/Dublin",
        "startTimestamp": 1736830800000
      },
      "tags": []
    }
 

以下のSLOは、平均遅延が200ミリ秒未満であることを示すサービス品質99％を目標としています。エラー予算は、固定された暦月単位の時間枠において分単位で計算されます。 これはバックエンドアプリケーションの観点から測定されます。 このSLOはアメリカ/ニューヨークのタイムゾーンに紐付けられています。 カレンダー月単位の時間枠は固定時間枠でのみサポートされ、1か月の期間に限定されます。 月の中旬に作成された場合、初期の測定期間は作成日からその月の最終日までとなり、以降の期間は完全な暦月に従います。

ペイロード:

{
  "name": "Payment Service Monthly Latency",
  "target": 0.99,
  "lastUpdated": 1737561600000,
  "entity": {
    "type": "application",
    "applicationId": "PaymentApp123456",
    "serviceId": null,
    "endpointId": null,
    "boundaryScope": "INBOUND",
    "includeInternal": false,
    "includeSynthetic": false,
    "tagFilterExpression": null
  },
  "indicator": {
    "type": "timeBased",
    "blueprint": "latency",
    "threshold": 200,
    "aggregation": "MEAN"
  },
  "timeWindow": {
    "type": "fixed",
    "duration": 1,
    "durationUnit": "calendar_month",
    "timezone": "America/New_York",
    "startTimestamp": 1737561600000
  },
  "tags": [
    "payment",
    "production",
    "monthly",
    "latency"
  ]
}

以下のSLOは、 HTTP のカートサービスにアクセスするAndroid端末のリクエスト遅延を監視し、99%の可用性を目標としています。 SLOでは、レイテンシが200ミリ秒未満の場合は「良好」、この閾値を超える場合は「不良」と分類されます。 エラーバジェットは、1日という固定の期間において、個々の HTTP リクエストビーコンごとに計算されます。

ペイロード:

{
  "name": "Mobile App Cart Service Latency - Android",
  "target": 0.99,
  "entity": {
    "type": "mobile",
    "mobileIds": [],
    "tagFilterExpression": {
      "type": "TAG_FILTER",
      "name": "mobileBeacon.platform",
      "stringValue": "Android",
      "numberValue": null,
      "booleanValue": null,
      "floatValue": null,
      "key": null,
      "value": "Android",
      "operator": "EQUALS",
      "entity": "NOT_APPLICABLE"
    }
  },
  "indicator": {
    "type": "eventBased",
    "threshold": 200,
    "operator": ">",
    "aggregation": "MEAN",
    "metric": {
      "name": "httpLatency",
      "scope": {
        "type": "httpRequest",
        "tagFilterExpression": {
          "type": "TAG_FILTER",
          "name": "mobileBeacon.http.url",
          "stringValue": "https://rs-cart/add-cart",
          "numberValue": null,
          "booleanValue": null,
          "floatValue": null,
          "key": null,
          "value": "https://rs-cart/add-cart",
          "operator": "EQUALS",
          "entity": "NOT_APPLICABLE"
        }
      }
    },
    "blueprint": "latency"
  },
  "timeWindow": {
    "type": "fixed",
    "duration": 1,
    "durationUnit": "day",
    "timezone": "UTC",
    "startTimestamp": 1782082800000
  },
  "tags": [
    "mobile",
    "android",
    "latency",
    "cart"
  ]
}

以下のSLOは、小売向けモバイルアプリのクラッシュによるセッション数を監視し、99%の可用性を目標としています。 エラー許容値は、固定された暦月の期間において、分単位で算出されます。 SLOでは、クラッシュの影響を受けたセッション数が15を超えた場合、その分間を「不良」と分類します。

ペイロード:

{
  "name": "Retail Mobile App - Crash Affected Sessions",
  "target": 0.99,
  "entity": {
    "type": "mobile",
    "mobileIds": [
      "i1IsNS7FQAegEljBTkNBMQ"
    ],
    "tagFilterExpression": {
      "type": "EXPRESSION",
      "logicalOperator": "AND",
      "elements": []
    }
  },
  "indicator": {
    "type": "timeBased",
    "threshold": 15,
    "operator": ">",
    "aggregation": "SUM",
    "metric": {
      "name": "crashAffectedSessionCount",
      "scope": {
        "type": "crash",
        "tagFilterExpression": {
          "type": "EXPRESSION",
          "logicalOperator": "AND",
          "elements": []
        }
      }
    },
    "blueprint": "availability"
  },
  "timeWindow": {
    "type": "fixed",
    "duration": 1,
    "durationUnit": "calendar_month",
    "timezone": "Europe/Dublin",
    "startTimestamp": 1781564400000
  },
  "tags": [
    "mobile",
    "crash",
    "availability"
  ]
}

以下のサービスレベル目標（SLO）では、カスタム指標を使用してモバイルアプリのユーザー体験を監視します。 このインジケーターは、 HTTP の高速な応答とスムーズな表示切り替えを組み合わせることで、99%の可用性を目指しています。 「良好なイベント」とは、レイテンシが 500 ms 未満の HTTP リクエストを指します。「不良なイベント」とは、処理時間が 300 ms を超えるビューの変更を指します。この SLO では、カスタムブループリントを使用して、さまざまなビーコンタイプにわたって監視を行う方法について説明します。

ペイロード:

{
  "name": "E-commerce Mobile App - User Experience",
  "target": 0.99,
  "entity": {
    "type": "mobile",
    "mobileIds": [
      "PwozCjutQEuJjQT01ktwOw",
      "i1IsNS7FQAegEljBTkNBMQ"
    ],
    "tagFilterExpression": {
      "type": "EXPRESSION",
      "logicalOperator": "AND",
      "elements": []
    }
  },
  "indicator": {
    "type": "eventBased",
    "goodEvents": {
      "aggregation": "SUM",
      "threshold": 500,
      "operator": "<",
      "metric": {
        "name": "httpLatency",
        "scope": {
          "type": "httpRequest",
          "tagFilterExpression": {
            "type": "EXPRESSION",
            "logicalOperator": "AND",
            "elements": []
          }
        }
      }
    },
    "badEvents": {
      "aggregation": "SUM",
      "threshold": 300,
      "operator": ">",
      "metric": {
        "name": "viewChangeDuration",
        "scope": {
          "type": "viewChange",
          "tagFilterExpression": {
            "type": "EXPRESSION",
            "logicalOperator": "AND",
            "elements": []
          }
        }
      }
    },
    "blueprint": "advanced-custom",
    "operator": null,
    "threshold": 0,
    "aggregation": "MEAN"
  },
  "timeWindow": {
    "type": "fixed",
    "duration": 1,
    "durationUnit": "calendar_month",
    "timezone": "UTC",
    "startTimestamp": 1782082800000
  },
  "tags": [
    "mobile",
    "custom",
    "user-experience"
  ]
}

この API 呼び出しは、コマンドに含まれる JSON ペイロードに基づいて、一意の新しいSLO構成を作成します。

curl 例：

echo -e ' \
{
  "name": "my SLO no 1",
  "target": 0.96,
  "lastUpdated": 1690357470848,
  "entity": {
    "type": "application",
    "applicationId": "LsEOORPeR0Gnt_kntZbosw",
    "serviceId": null,
    "endpointId": null,
    "boundaryScope": "ALL",
    "includeInternal": false,
    "includeSynthetic": false,
    "tagFilterExpression": null
  },
  "indicator": {
    "type": "timeBased",
    "blueprint": "latency",
    "threshold": 341,
    "aggregation": "MEAN"
  },
  "timeWindow": {
    "type": "rolling",
    "duration": 7,
    "durationUnit": "day",
    "timezone": "America/Chicago"
  },
  "tags": [
    "food",
    "snacks",
    "timeBased",
    "latency",
    "demo"
  ]
}
' | curl -X POST -H "Content-Type: application/json" -H 'authorization: apiToken XXXXXXXXXXXXXX' https://instana.rocks/api/settings/slo -d @-