チュートリアル: トレース データを持つアプリケーション パースペクティブのサービスを一覧表示する

このエンドポイントはコマンドラインからテストできます。 HTTP へのRESTリクエストを行うために必要な情報が揃っているか、また適切なアクセス権限を持っているかを、すぐに確認できます。 また、調査可能なレスポンスのペイロードも提供されます。

curl -XPOST https://{tenant}-{unit}.instana.io/api/application-monitoring/analyze/call-groups
  -H "Content-Type: application/json"
  -H "authorization: apiToken {apiToken}"
  -d '{
    "timeFrame": {
        "to": 1720080007860,
        "windowSize": 3600000
    },
    "tagFilterExpression": {
        "type": "TAG_FILTER",
        "name": "application.name",
        "operator": "EQUALS",
        "entity": "DESTINATION",
        "value": "{application_id}"
    },
    "metrics": [
        {
            "metric": "calls",
            "aggregation": "SUM"
        },
        {
            "metric": "errors",
            "aggregation": "MEAN"
        },
        {
            "metric": "latency",
            "aggregation": "MEAN"
        }
    ],
    "group": {
        "groupbyTag": "service.name",
        "groupbyTagEntity": "DESTINATION"
    }
  }'

特定のアプリケーションのサービス一覧をプログラムで自動的に取得するには、 Python 関数を使用してみてください。この関数は、ライブラリ requests を利用して、 GET grouped call metrics エンドポイント経由で指定されたアプリケーションのすべてのサービスを取得します。

ローカルマシンに Python 環境がセットアップされていない場合は、 Google Colab の「 Jupyter Notebook 」を使用してこの関数を試すことができます。これは、ブラウザ上で Python コードを記述・実行できる環境を提供するものです。 使用するにはGoogleColab、必要なのはGoogleアカウント。 このリンクから、Colabで Jupyter Notebook を作成してください。

API メソッドを呼び出すと、以下のコードブロックに示すような「 JSON 」というレスポンスが返ってくる場合があります。 {application_id} 向けのサービスで、トレースデータが提供されているものは、この items リストに記載されています。 次の例では、トレースデータを持つ「サービスA」と「サービスB」の2つのサービスがあります。

  {
  "items": [
    {
      "name": "Service A",
      "timestamp": 1720076400000,
      "cursor": {
        "@class": ".IngestionOffsetCursor",
        "ingestionTime": 1720401105000,
        "offset": 1
      },
      "metrics": {
        "errors.mean": [
          [
            1720080000000,
            0.0
          ]
        ],
        "calls.sum": [
          [
            1720080000000,
            200
          ]
        ],
        "latency.mean": [
          [
            1720080000000,
            0.500
          ]
        ]
      }
    },
    {
      "name": "Service B",
      "timestamp": 1720076400000,
      "cursor": {
        "@class": ".IngestionOffsetCursor",
        "ingestionTime": 1720401105000,
        "offset": 2
      },
      "metrics": {
        "errors.mean": [
          [
            1720080000000,
            1.5
          ]
        ],
        "calls.sum": [
          [
            1720080000000,
            150
          ]
        ],
        "latency.mean": [
          [
            1720080000000,
            2.200
          ]
        ]
      }
    }
    // More services...
  ],
  "canLoadMore": false,
  "totalHits": 2,
  "totalRepresentedItemCount": 2,
  "totalRetainedItemCount": 2,
  "adjustedTimeframe": {
    "windowSize": 3600000,
    "to": 1720080000000
  }
}