教程：为应用程序视角列出具有跟踪数据的服务

您可以通过命令行测试此接口。 您可以快速确认是否具备向 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 代码。 要使用 Google Colab，您需要一个 Google 账户。 请点击此链接在 Colab 中创建一个 Jupyter Notebook。

调用 ` API ` 时，您可能会收到类似于以下代码块所示的 ` JSON ` 响应。 该 items 列表中列出了所有包含跟踪数据的 {application_id} 服务。 在下面的示例中，有两个服务（服务 A 和服务 B）拥有跟踪数据。

  {
  "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
  }
}