Application Real-Time Monitoring Service:ビジネストレースのベストプラクティス

ステップ 1：ビジネスパラメータを抽出する

ビジネスパラメータ抽出ルールを構成することにより、システムはリクエストパラメータからビジネスディメンション識別子を自動的に解析できます。ジュエリーカテゴリの注文配置インターフェイスを例にとると、「カテゴリ」情報は入力パラメータから取得され、サンプルコードでは、注文カテゴリ情報は CommonRequestBody オブジェクトにあります。

@RequestMapping(value = "/order", produces = "application/json", method = RequestMethod.POST)
    public CommonResult<?> order(@RequestBody CommonRequestBody requestBody) throws Exception {
        bizO11yHandleService.syncCall(requestBody);
        return CommonResult.succeeded(new CommonData("Cache",
                "{\"param1\":\"value1\",\"resultCode\":" + requestBody.getCode() + "}",
                "succeeded.", requestBody.getCode()));
    }

注文配置インターフェイスのCommonRequestBody では、ビジネスカテゴリ識別子category は、リクエスト本文のネストされたオブジェクトextraInfo に格納されています。

@Data
public class CommonRequestBody {

    private String requestId;

    private int code;

    private boolean needDetail;

    private Map<String, String> extraInfo;
}

{
  "code": 200,
  "needDetail": true,
  "requestId": "req-32413",
  "extraInfo": {
    "orderNumber": "ord-xxxxx",
    "level": "vip",
    "arms": "good",
    "source": "app",
    "category": "jewelry"
  }
}

カテゴリ情報を見つけたら、エントリアプリケーションの [構成] > [ビジネスパラメータ抽出ルール] ページで、非侵入型でジュエリーカテゴリのカテゴリ属性を抽出できます。詳細については、「ビジネスパラメータを抽出する」をご参照ください。

ステップ 2：ビジネストレースを構成する

抽出されたcategory ビジネスパラメータに基づいて、ビジネス トレース リスト ページでこのビジネスパラメータのトレースを構成します。

ステップ 3：アラートを構成する

ジュエリー固有の注文配置トレースを分離したら、このトレース専用のアラートを構成できます。

ビジネストレース監視のデータソースは、デフォルトで Managed Service for Prometheus に統合されており、対応するインスタンス名は metricstore-apm-metrics-custom_<regionId>_default-cms-<userId>-<region> です。PromQL ステートメントを作成することで、カスタムアラート構成を完了できます。

たとえば、注文リクエスト数が 1 を超えた場合にアラートをトリガーする場合、対応する PromQL ステートメントは次のようになります。

sum(sum_over_time_lorc(arms_biz_app_requests_count_raw{_biz_code="jewelry_order",serverIp=~".*",callKind=~"http|rpc|custom_entry|server|consumer|schedule",pid="ckv8e2vzfj@f17de22dde9bd19",rpc=~"/api/v1/biz/order",source="apm",}[1m]))>1

sum(sum_over_time_lorc(arms_biz_app_requests_count_raw{_biz_code="jewelry_order",serverIp=~".*",callKind=~"http|rpc|custom_entry|server|consumer|schedule",pid="ckv8e2vzfj@f17de22dde9bd19",rpc=~"/api/v1/biz/order",source="apm",}[$__range])) or vector(0)

sum(sum_over_time_lorc(arms_biz_app_requests_count_raw{_biz_code="jewelry_order",serverIp=~".*",callKind=~"http|rpc|custom_entry|server|consumer|schedule",pid="ckv8e2vzfj@f17de22dde9bd19",rpc=~"/api/v1/biz/order",source="apm",}[1m]))>1