

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 匯出指標
<a name="metrics"></a>

**重要**  
支援終止通知：2026 年 9 月 30 日， AWS 將停止支援 AWS App Mesh。2026 年 9 月 30 日之後，您將無法再存取 AWS App Mesh 主控台或 AWS App Mesh 資源。如需詳細資訊，請參閱此部落格文章[從 遷移 AWS App Mesh 至 Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)。

Envoy 會對自己的操作和傳入和傳出流量的各種維度發出許多統計資料。若要進一步了解 Envoy 統計資料，請參閱 Envoy 文件中的[統計資料](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/statistics)。這些指標可透過代理管理連接埠上的`/stats`端點取得，通常為 `9901`。

字`stat`首會有所不同，取決於您使用的是單一或多個接聽程式。以下是一些說明差異的範例。

**警告**  
如果您將單一接聽程式更新為多個接聽程式功能，您可能會因為下表中說明的更新統計資料字首而面臨重大變更。  
 我們建議您使用 Envoy 映像`1.22.2.1-prod`或更新版本。這可讓您在 Prometheus 端點中查看類似的指標名稱。


| 單一接聽程式 (SL)/具有「輸入」接聽程式字首的現有統計資料 | 具有「輸入.<protocol>.<port>」接聽程式字首的多個接聽程式 (ML)/新統計資料 | 
| --- | --- | 
|  `http.*ingress*.rds.rds_ingress_http_5555.version_text`  |  `http.*ingress.http.5555*.rds.rds_ingress_http_5555.version_text` `http.*ingress.http.6666*.rds.rds_ingress_http_6666.version_text`  | 
|  `listener.0.0.0.0_15000.http.*ingress*.downstream_rq_2xx`  |  `listener.0.0.0.0_15000.http.*ingress.http.5555*.downstream_rq_2xx` `listener.0.0.0.0_15000.http.*ingress.http.6666*.downstream_rq_2xx`  | 
|  `http.*ingress*.downstream_cx_length_ms`  |  `http.*ingress.http.5555*.downstream_cx_length_ms` `http.*ingress.http.6666*.downstream_cx_length_ms`  | 

如需統計資料端點的詳細資訊，請參閱 Envoy 文件中的[統計資料端點](https://www.envoyproxy.io/docs/envoy/latest/operations/admin#get--stats)。如需管理介面的詳細資訊，請參閱 [啟用 Envoy 代理管理界面](troubleshooting-best-practices.md#ts-bp-enable-proxy-admin-interface)。

## 搭配 Amazon EKS 的 App Mesh Prometheus
<a name="prometheus"></a>

**重要**  
支援終止通知：2026 年 9 月 30 日， AWS 將停止支援 AWS App Mesh。2026 年 9 月 30 日之後，您將無法再存取 AWS App Mesh 主控台或 AWS App Mesh 資源。如需詳細資訊，請參閱此部落格文章[從 遷移 AWS App Mesh 至 Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)。

Prometheus 是一種開放原始碼監控和警示工具組。其功能之一是指定發出指標的格式，以供其他系統使用。如需 Prometheus 的詳細資訊，請參閱 Prometheus 文件中的[概觀](https://prometheus.io/docs/introduction/overview/)。Envoy 可以透過傳入 參數，透過其統計資料端點發出其指標`/stats?format=prometheus`。

對於使用 Envoy 映像建置 v1.22.2.1-prod 的客戶，有兩個額外的維度來表示輸入接聽程式特定統計資料：
+ `appmesh.listener_protocol`
+ `appmesh.listener_port`

以下是 Prometheus 現有統計資料與新統計資料之間的比較。
+ 具有「輸入」接聽程式字首的現有統計資料

  ```
  envoy_http_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",envoy_http_conn_manager_prefix="ingress"} 931433
  ```
+ 具有 "inress.<protocol>.<port>" \$1 Appmesh Envoy Image v1.22.2.1-prod 或更新版本的新統計資料

  ```
  envoy_http_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",appmesh_listener_protocol="http",appmesh_listener_port="5555",envoy_http_conn_manager_prefix="ingress"} 20
  ```
+ 具有 "inress.<protocol>.<port>" \$1 自訂 Envoy Imagebuild 的新統計資料

  ```
  envoy_http_http_5555_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",envoy_http_conn_manager_prefix="ingress"} 15983
  ```

對於多個接聽程式，`cds_ingress_<mesh name>_<virtual gateway name>_self_redirect_<ingress_listener_port>_<protocol>_<port>`特殊叢集將是接聽程式特定的。
+ 具有「輸入」接聽程式字首的現有統計資料

  ```
  envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",Mesh="multiple-listeners-mesh",VirtualGateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_http_15001"} 0
  ```
+ 具有 "inress.<protocol>.<port>" 的新統計資料

  ```
  envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_1111_http_15001"} 0
  envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_2222_http_15001"} 0
  ```

### 安裝 Prometheus
<a name="installing-prometheus"></a>

1. 將 EKS 儲存庫新增至 Helm：

   ```
   helm repo add eks https://aws.github.io/eks-charts
   ```

1. 安裝 App Mesh Prometheus

   ```
   helm upgrade -i appmesh-prometheus eks/appmesh-prometheus \
   --namespace appmesh-system
   ```

### Prometheus 範例
<a name="prometheus-sample"></a>

以下是`PersistentVolumeClaim`為 Prometheus 持久性儲存建立 的範例。

```
helm upgrade -i appmesh-prometheus eks/appmesh-prometheus \
--namespace appmesh-system \
--set retention=12h \
--set persistentVolumeClaim.claimName=prometheus
```

### 使用 Prometheus 的逐步解說
<a name="prometheus-walkthrough"></a>
+ [App Mesh with EKS - 可觀測性：Prometheus](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-prometheus.md)

### 若要進一步了解使用 Amazon EKS 的 Prometheus 和 Prometheus
<a name="prometheus-eks"></a>
+ [Prometheus 文件](https://prometheus.io/docs/introduction/overview/)
+ **EKS -** [使用 Prometheus 控制平面指標](https://docs.aws.amazon.com/eks/latest/userguide/prometheus.html)

## 適用於 App Mesh 的 CloudWatch
<a name="cloudwatch"></a>

**重要**  
支援終止通知：2026 年 9 月 30 日， AWS 將停止支援 AWS App Mesh。2026 年 9 月 30 日之後，您將無法再存取 AWS App Mesh 主控台或 AWS App Mesh 資源。如需詳細資訊，請參閱此部落格文章[從 遷移 AWS App Mesh 至 Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)。

**從 Amazon EKS 將 Envoy 統計資料傳送至 CloudWatch**  
您可以將 CloudWatch Agent 安裝到您的叢集，並將其設定為從您的代理收集一部分指標。如果您還沒有 Amazon EKS 叢集，則可以使用 GitHub 上的[逐步解說：App Mesh with Amazon EKS](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/eks) 中的步驟建立叢集。您可以依照相同的逐步解說，在叢集上安裝範例應用程式。

若要為您的叢集設定適當的 IAM 許可並安裝代理程式，請遵循[使用 Prometheus 指標集合安裝 CloudWatch 代理程式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-Setup.html)中的步驟。預設安裝包含 Prometheus 湊集組態，可提取 Envoy 統計資料的有用子集。如需詳細資訊，請參閱 [App Mesh 的 Prometheus 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-metrics.html#ContainerInsights-Prometheus-metrics-appmesh)。

若要建立 App Mesh 自訂 CloudWatch 儀表板，設定為顯示代理程式收集的指標，請遵循[檢視您的 Prometheus 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-viewmetrics.html)教學課程中的步驟。當流量進入 App Mesh 應用程式時，您的圖形會開始填入對應的指標。

### 篩選 CloudWatch 的指標
<a name="filtering-metrics"></a>

App Mesh [指標延伸](https://docs.aws.amazon.com/app-mesh/latest/userguide/metrics.html#metrics-extension)提供有用的指標子集，可讓您深入了解您在網格中定義之資源的行為。由於 CloudWatch 代理程式支援抓取 Prometheus 指標，因此您可以提供抓取組態，以選取要從 Envoy 提取並傳送至 CloudWatch 的指標。

您可以在我們的指標[延伸演練中找到使用 Prometheus 抓取指標](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-metrics-extension-ecs)的範例。

### CloudWatch 範例
<a name="cloudwatch-sample"></a>

您可以在我們的範例儲存庫中找到 CloudWatch 的範例組態。 [AWS](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent)

### 使用 CloudWatch 的逐步解說
<a name="cloudwatch-walkthrough"></a>
+ 在我們的 [App Mesh 研討會](https://www.appmeshworkshop.com/introduction/)中[新增監控和記錄功能](https://www.appmeshworkshop.com/monitoring/)。
+ [App Mesh with EKS - 可觀測性：CloudWatch](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-cloudwatch.md)
+ [在 ECS 上使用 App Mesh 的指標延伸](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-metrics-extension-ecs)

## App Mesh 的指標延伸
<a name="metrics-extension"></a>

**重要**  
支援終止通知：2026 年 9 月 30 日， AWS 將停止支援 AWS App Mesh。2026 年 9 月 30 日之後，您將無法再存取 AWS App Mesh 主控台或 AWS App Mesh 資源。如需詳細資訊，請參閱此部落格文章[從 遷移 AWS App Mesh 至 Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)。

Envoy 會產生數百個指標，分為幾個不同的維度。指標與 App Mesh 的關係並不直接。在虛擬服務的情況下，沒有機制可以確定哪個虛擬服務正在與指定的虛擬節點或虛擬閘道通訊。

App Mesh 指標延伸可增強在網格中執行的 Envoy 代理。此增強功能可讓代理發出了解您定義之資源的其他指標。這個小部分的其他指標將協助您更深入了解您在 App Mesh 中定義的這些資源的行為。

若要啟用 App Mesh 指標延伸，請將環境變數設定為 `APPMESH_METRIC_EXTENSION_VERSION` `1`。

```
APPMESH_METRIC_EXTENSION_VERSION=1
```

如需 Envoy 組態變數的詳細資訊，請參閱 [Envoy 組態變數](envoy-config.md)。

### 與傳入流量相關的指標
<a name="inbound-metrics"></a>
+ `ActiveConnectionCount`
  + `envoy.appmesh.ActiveConnectionCount` — 作用中 TCP 連線的數量。
  + *維度* — Mesh、VirtualNode、VirtualGateway
+ **`NewConnectionCount`**
  + `envoy.appmesh.NewConnectionCount` — TCP 連線總數。
  + *維度* — Mesh、VirtualNode、VirtualGateway
+ **`ProcessedBytes`**
  + `envoy.appmesh.ProcessedBytes` — 從下游用戶端傳送和接收的總 TCP 位元組。
  + *維度* — Mesh、VirtualNode、VirtualGateway
+ **`RequestCount`**
  + `envoy.appmesh.RequestCount` — 已處理的 HTTP 請求數目。
  + *維度* — Mesh、VirtualNode、VirtualGateway
+ **`GrpcRequestCount`**
  + `envoy.appmesh.GrpcRequestCount` — 已處理的 gPRC 請求數目。
  + *維度* — Mesh、VirtualNode、VirtualGateway

### 與傳出流量相關的指標
<a name="outbound-metrics"></a>

根據輸出指標是否來自虛擬節點或虛擬閘道，您會在輸出指標上看到不同的維度。
+ `TargetProcessedBytes`
  + `envoy.appmesh.TargetProcessedBytes` — 從 Envoy 上游的目標傳送和接收的總 TCP 位元組數。
  + 

    *維度*：
    + 虛擬節點維度 — Mesh、VirtualNode、TargetVirtualService、TargetVirtualNode
    + 虛擬閘道維度 — Mesh、VirtualGateway、TargetVirtualService、TargetVirtualNode
+ **`HTTPCode_Target_2XX_Count`**
  + `envoy.appmesh.HTTPCode_Target_2XX_Count` — 對 Envoy 上游目標發出導致 2xx HTTP 回應的 HTTP 請求數量。
  + 

    *維度*：
    + 虛擬節點維度 — Mesh、VirtualNode、TargetVirtualService、TargetVirtualNode
    + 虛擬閘道維度 — Mesh、VirtualGateway、TargetVirtualService、TargetVirtualNode
+ **`HTTPCode_Target_3XX_Count`**
  + `envoy.appmesh.HTTPCode_Target_3XX_Count` — 對 Envoy 上游目標發出導致 3xx HTTP 回應的 HTTP 請求數量。
  + 

    *維度*：
    + 虛擬節點維度 — Mesh、VirtualNode、TargetVirtualService、TargetVirtualNode
    + 虛擬閘道維度 — Mesh、VirtualGateway、TargetVirtualService、TargetVirtualNode
+ **`HTTPCode_Target_4XX_Count`**
  + `envoy.appmesh.HTTPCode_Target_4XX_Count` — 對 Envoy 上游目標發出導致 4xx HTTP 回應的 HTTP 請求數量。
  + 

    *維度*：
    + 虛擬節點維度 — Mesh、VirtualNode、TargetVirtualService、TargetVirtualNode
    + 虛擬閘道維度 — Mesh、VirtualGateway、TargetVirtualService、TargetVirtualNode
+ **`HTTPCode_Target_5XX_Count`**
  + `envoy.appmesh.HTTPCode_Target_5XX_Count` — 對 Envoy 上游目標發出導致 5xx HTTP 回應的 HTTP 請求數目。
  + 

    *維度*：
    + 虛擬節點維度 — Mesh、VirtualNode、TargetVirtualService、TargetVirtualNode
    + 虛擬閘道維度 — Mesh、VirtualGateway、TargetVirtualService、TargetVirtualNode
+ **`RequestCountPerTarget`**
  + `envoy.appmesh.RequestCountPerTarget` — 傳送至 Envoy 上游目標的請求數量。
  + 

    *維度*：
    + 虛擬節點維度 — Mesh、VirtualNode、TargetVirtualService、TargetVirtualNode
    + 虛擬閘道維度 — Mesh、VirtualGateway、TargetVirtualService、TargetVirtualNode
+ **`TargetResponseTime`**
  + `envoy.appmesh.TargetResponseTime` — 從向 Envoy 上游的目標提出請求到收到完整回應所經過的時間。
  + 

    *維度*：
    + 虛擬節點維度 — Mesh、VirtualNode、TargetVirtualService、TargetVirtualNode
    + 虛擬閘道維度 — Mesh、VirtualGateway、TargetVirtualService、TargetVirtualNode

## App Mesh 的 Datadog
<a name="datadog"></a>

**重要**  
支援終止通知：2026 年 9 月 30 日， AWS 將停止支援 AWS App Mesh。2026 年 9 月 30 日之後，您將無法再存取 AWS App Mesh 主控台或 AWS App Mesh 資源。如需詳細資訊，請參閱此部落格文章[從 遷移 AWS App Mesh 至 Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)。

Datadog 是一種監控和安全性應用程式，用於雲端應用程式的端對端監控、指標和記錄。Datadog 可讓您的基礎設施、應用程式和第三方應用程式完全可見。

### 安裝 Datadog
<a name="installing-datadog"></a>
+ EKS - 若要使用 EKS 設定 Datadog，請遵循 [Datadog 文件](https://docs.datadoghq.com/integrations/amazon_app_mesh/?tab=eks)中的以下步驟。
+ ECS EC2 - 若要使用 ECS EC2 設定 Datadog，請遵循 [Datadog 文件](https://docs.datadoghq.com/integrations/amazon_app_mesh/?tab=ecsec2)中的下列步驟。

### 若要進一步了解 Datadog
<a name="datadog-learn-more"></a>
+ [Datadog 文件](https://docs.datadoghq.com/)