本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 設定指標串流 依照以下各節中的步驟，設定 CloudWatch 指標串流。 建立指標串流後，指標資料出現在目的地所需的時間取決於 Firehose 傳輸串流上設定的緩衝設定。緩衝以最大酬載大小或最大等待時間表示，以先到達者為準。如果將這些值設定為最小值 (60 秒、1MB)，並且選取的 CloudWatch 命名空間設有作用中指標更新，則預期的延遲會在 3 分鐘內。 在 CloudWatch 指標串流中，資料會每分鐘傳送。資料可能不會按順序到達最終目的地。指定命名空間中的所有指定指標都會在指標串流中傳送，但時間戳記超過兩天的指標除外。 對於您串流的每個指標名稱與命名空間組合，系統都會對該指標名稱與命名空間的所有維度組合進行串流處理。 對於監控帳戶中的指標串流，您可以選擇是否包含來自連結至該監控帳戶之來源帳戶的指標。如需詳細資訊，請參閱[CloudWatch 跨帳戶觀察功能](CloudWatch-Unified-Cross-Account.md)。 若要建立和管理指標串流，您必須登入具有 **CloudWatchFullAccess** 政策和 `iam:PassRole` 許可的帳戶，或是具有以下許可清單的帳戶： + `iam:PassRole` + `cloudwatch:PutMetricStream` + `cloudwatch:DeleteMetricStream` + `cloudwatch:GetMetricStream` + `cloudwatch:ListMetricStreams` + `cloudwatch:StartMetricStreams` + `cloudwatch:StopMetricStreams` 如果您要讓 CloudWatch 設定指標串流所需的 IAM 角色，則還必須設有 `iam:CreateRole` 和 `iam:PutRolePolicy` 許可。 **重要** 擁有 `cloudwatch:PutMetricStream` 的使用者已存取正在串流處理的 CloudWatch 指標資料，即使它們沒有 `cloudwatch:GetMetricData` 許可。 **Topics** + [ # Firehose 的自訂設定 ](CloudWatch-metric-streams-setup-datalake.md) + [ # 使用 Quick Amazon S3 設定 ](CloudWatch-metric-streams-setup-Quick-S3.md) + [ # 快速合作夥伴設定 ](CloudWatch-metric-streams-QuickPartner.md) # Firehose 的自訂設定 使用此方法來建立指標串流，然後將其引導至 Amazon Data Firehose 傳輸串流，以便將您的 CloudWatch 指標傳輸到所需的位置。您可將其串流至 Amazon S3 等資料湖，或 Firehose 支援的任何目的地或端點，包括第三方供應商。 原生支援 JSON、OpenTelemetry 1.0.0 和 OpenTelemetry 0.7.0 格式，您也可在 Firehose 傳輸串流中設定轉換，將資料轉換為不同的格式，例如 Parquet。透過指標串流，您可持續更新監控資料，或將此 CloudWatch 指標資料與計費和效能資料結合，進而建立豐富的資料集。然後，您可以使用 Amazon Athena 之類的工具，深入了解成本最佳化、資源效能和資源使用率。 您可以使用 CloudWatch 主控台 AWS CLI AWS CloudFormation、 或 AWS Cloud Development Kit (AWS CDK) 來設定指標串流。 您用於指標串流的 Firehose 傳輸串流必須位於您設定指標串流的相同帳戶及相同區域中。若要實現跨區域功能，您可以設定 Firehose 傳輸串流，以串流至不同帳戶或不同區域中的最終目的地。 ## CloudWatch 主控台 本節會描述如何透過 CloudWatch 主控台，使用 Firehose 來設定指標串流。 **使用 Firehose 設定自訂指標串流** 1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。 1. 在導覽窗格中，選擇 **Metrics** (指標)、**Streams** (串流)。然後選擇 **Create metric stream** (建立指標串流)。 1. (選用) 若您登入的帳戶已設定為 CloudWatch 跨帳戶觀察功能中的監控帳戶，則可以選擇是否在此指標串流中包含來自連結之來源帳戶的指標。若要包含來自來源帳戶的指標，請選擇 **Include source account metrics** (包含來源帳戶指標)。 1. 選擇**使用 Firehose 進行自訂設定**。 1. 然後，在**選取您的 Kinesis Data Firehose 串流**下，選取要使用的 Firehose 傳輸串流。它必須位於同個帳戶中。此選項的預設格式為 OpenTelemetry 0.7.0，但您可以稍後在此程序中變更格式。 然後，在**選取您的 Firehose 傳輸串流**下，選取要使用的 Firehose 傳輸串流。 1. (選用) 您可選擇**選取現有的服務角色**，以使用現有的 IAM 角色，而不是讓 CloudWatch 為您建立新的角色。 1. (選用) 若要變更案例的預設格式的輸出格式，請選擇 **Change output format** (變更輸出格式)。支援的格式為 JSON、OpenTelemetry 1.0.0 和 OpenTelemetry 0.7.0。 1. 對於**要串流的指標**，請選擇**所有指標**或**選取指標**。 如果您選擇**所有指標**，此帳戶的所有指標都會包含在串流中。 請仔細考慮是否要串流所有指標，因為串流的指標數量越多，指標串流的費用就越高。 如果您選擇**選取指標**，請執行下列動作之一： + 若要串流大多數指標命名空間，請選擇**排除**，然後選取要排除的命名空間或指標。當您在**排除**中指定命名空間時，可以選擇從該命名空間中選取一些要排除的特定指標。如果您選擇排除某個命名空間，但未在該命名空間中選取指標，則該命名空間中的所有指標都會排除。 + 若只要在指標串流中包含少數指標命名空間，請選擇**包含**，然後選取要包含的命名空間或指標。如果您選擇包含某個命名空間，但未在該命名空間中選取指標，則該命名空間中的所有指標都會包含在內。 1. (選用) 若要為這些指標中的某些指標串流除最小值、最大值、樣本計數和總和之外的額外統計資料，請選擇**新增額外統計資料**。您可以選擇 **Add recommended metrics** (新增建議的指標) 以新增常用統計數字，或手動選取要為其串流額外統計數字的命名空間和指標名稱。然後選取要串流的額外統計數字。 選擇要為其串流不同額外統計數字集的另一組指標，然後選擇 **Add additional statistics** (新增額外統計數字)。每個指標可以包含多達 20 個額外統計數字，而一個指標串流中具有多達 100 個能夠包含額外統計數字的指標。 串流額外統計數字會產生更多費用。如需詳細資訊，請參閱[可供串流的統計數字](CloudWatch-metric-streams-statistics.md)。 如需有關額外統計數字的定義，請參閱 [CloudWatch 統計資料定義](Statistics-definitions.md)。 1. (選用) 在 **Metric stream name** (指標串流名稱) 下，自訂新指標串流的名稱。 1. 選擇 **Create metric stream** (建立指標串流)。 ## AWS CLI 或 AWS API 使用下列步驟，建立 CloudWatch 指標串流。 **使用 AWS CLI 或 AWS API 建立指標串流** 1. 如果您要串流到 Simple Storage Service (Amazon S3)，請先建立儲存貯體。如需詳細資訊，請參閱[建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)。 1. 建立 Firehose 傳輸串流。如需詳細資訊，請參閱[建立 Firehose 串流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。 1. 建立 IAM 角色，讓 CloudWatch 能夠寫入 Firehose 傳輸串流。如需此角色之內容的詳細資訊，請參閱 [CloudWatch 與 Firehose 之間的信任](CloudWatch-metric-streams-trustpolicy.md)。 1. 使用 `aws cloudwatch put-metric-stream` CLI 命令或 `PutMetricStream` API，以建立 CloudWatch 指標串流。 ## AWS CloudFormation 您可以使用 CloudFormation 來設定指標串流。如需詳細資訊，請參閱 [AWS::CloudWatch::MetricStream](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-metricstream.html)。 **使用 CloudFormation 建立指標串流** 1. 如果您要串流到 Simple Storage Service (Amazon S3)，請先建立儲存貯體。如需詳細資訊，請參閱[建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)。 1. 建立 Firehose 傳輸串流。如需詳細資訊，請參閱[建立 Firehose 串流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。 1. 建立 IAM 角色，讓 CloudWatch 能夠寫入 Firehose 傳輸串流。如需此角色之內容的詳細資訊，請參閱 [CloudWatch 與 Firehose 之間的信任](CloudWatch-metric-streams-trustpolicy.md)。 1. 在其中建立串流 CloudFormation。如需詳細資訊，請參閱 [AWS::CloudWatch::MetricStream](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-metricstream.html)。 ## AWS Cloud Development Kit (AWS CDK) 您可以使用 AWS Cloud Development Kit (AWS CDK) 來設定指標串流。 **使用 AWS CDK 建立指標串流** 1. 如果您要串流到 Simple Storage Service (Amazon S3)，請先建立儲存貯體。如需詳細資訊，請參閱[建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)。 1. 建立 Firehose 傳輸串流。如需詳細資訊，請參閱[建立 Amazon Data Firehose 傳輸串流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。 1. 建立 IAM 角色，讓 CloudWatch 能夠寫入 Firehose 傳輸串流。如需此角色之內容的詳細資訊，請參閱 [CloudWatch 與 Firehose 之間的信任](CloudWatch-metric-streams-trustpolicy.md)。 1. 建立指標串流。指標串流資源可在 AWS CDK 中做為名為 的第 1 級 (L1) 建構`CfnMetricStream`。如需詳細資訊，請參閱[使用 L1 建構](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html#constructs_l1_using.html)。 # 使用 Quick Amazon S3 設定 如果想要快速設定 Amazon S3 的串流，並且不需要受支援的 JSON、OpenTelemetry 1.0.0 和 OpenTelemetry 0.7.0 格式之外的任何格式轉換，則 **Quick S3 Setup** 方法非常適合。CloudWatch 將建立所有必要的資源，包括 Firehose 傳輸串流和必要的 IAM 角色。此選項的預設格式為 JSON，但您可在設定串流時變更格式。 或者，如果您希望最終格式為 Parquet 格式或 Optimized Row Columnar (ORC)，您應改為遵循 [Firehose 的自訂設定](CloudWatch-metric-streams-setup-datalake.md) 中的步驟。 ## CloudWatch 主控台 本節會描述如何透過 CloudWatch 主控台，使用 Quick S3 Setup 來設定指標串流 Amazon S3。 **使用 Quick S3 Setup 設定指標串流** 1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。 1. 在導覽窗格中，選擇 **Metrics** (指標)、**Streams** (串流)。然後選擇 **Create metric stream** (建立指標串流)。 1. (選用) 若您登入的帳戶已設定為 CloudWatch 跨帳戶觀察功能中的監控帳戶，則可以選擇是否在此指標串流中包含來自連結之來源帳戶的指標。若要包含來自來源帳戶的指標，請選擇 **Include source account metrics** (包含來源帳戶指標)。 1. 選擇 **Quick S3 Setup**。CloudWatch 將建立所有必要的資源，包括 Firehose 傳輸串流和必要的 IAM 角色。此選項的預設格式為 JSON，但您可以稍後在此程序中變更格式。 1. (選用) 選擇**選取現有資源**，以使用現有的 S3 儲存貯體或現有的 IAM 角色，而不是讓 CloudWatch 為您建立新的儲存貯體。 1. (選用) 若要變更案例的預設格式的輸出格式，請選擇 **Change output format** (變更輸出格式)。支援的格式為 JSON、OpenTelemetry 1.0.0 和 OpenTelemetry 0.7.0。 1. 對於**要串流的指標**，請選擇**所有指標**或**選取指標**。 如果您選擇**所有指標**，此帳戶的所有指標都會包含在串流中。 請仔細考慮是否要串流所有指標，因為串流的指標數量越多，指標串流的費用就越高。 如果您選擇**選取指標**，請執行下列動作之一： + 若要串流大多數指標命名空間，請選擇**排除**，然後選取要排除的命名空間或指標。當您在**排除**中指定命名空間時，可以選擇從該命名空間中選取一些要排除的特定指標。如果您選擇排除某個命名空間，但未在該命名空間中選取指標，則該命名空間中的所有指標都會排除。 + 若只要在指標串流中包含少數指標命名空間，請選擇**包含**，然後選取要包含的命名空間或指標。如果您選擇包含某個命名空間，但未在該命名空間中選取指標，則該命名空間中的所有指標都會包含在內。 1. (選用) 若要為這些指標中的某些指標串流除最小值、最大值、樣本計數和總和之外的額外統計資料，請選擇**新增額外統計資料**。您可以選擇 **Add recommended metrics** (新增建議的指標) 以新增常用統計數字，或手動選取要為其串流額外統計數字的命名空間和指標名稱。然後選取要串流的額外統計數字。 選擇要為其串流不同額外統計數字集的另一組指標，然後選擇 **Add additional statistics** (新增額外統計數字)。每個指標可以包含多達 20 個額外統計數字，而一個指標串流中具有多達 100 個能夠包含額外統計數字的指標。 串流額外統計數字會產生更多費用。如需詳細資訊，請參閱[可供串流的統計數字](CloudWatch-metric-streams-statistics.md)。 如需有關額外統計數字的定義，請參閱 [CloudWatch 統計資料定義](Statistics-definitions.md)。 1. (選用) 在 **Metric stream name** (指標串流名稱) 下，自訂新指標串流的名稱。 1. 選擇 **Create metric stream** (建立指標串流)。 # 快速合作夥伴設定 CloudWatch 可為下列第三方合作夥伴提供快速設定體驗。若要使用此工作流程，您需要為目的地提供目的地 URL 和 API 金鑰。CloudWatch 將處理其他設定，包括建立 Firehose 傳輸串流和必要的 IAM 角色。 **重要** 在您使用快速合作夥伴設定來建立指標串流之前，強烈建議您先閱讀下列清單中連結的合作夥伴文件。 + [Datadog](https://docs.datadoghq.com/integrations/guide/aws-cloudwatch-metric-streams-with-kinesis-data-firehose/) + [Dynatrace](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication) + [彈性](https://www.elastic.co/docs/current/integrations/awsfirehose) + [New Relic](https://docs.newrelic.com/install/aws-cloudwatch/) + [Splunk Observability Cloud](https://docs.splunk.com/observability/en/gdi/get-data-in/connect/aws/aws-console-ms.html) + [SumoLogic](https://www.sumologic.com) 當您將指標串流設定到這些合作夥伴之一時，系統會使用某些預設設定來建立串流，如以下章節所列示。 **Topics** + [ ## 使用快速合作夥伴設定來設定指標串流 ](#CloudWatch-metric-streams-QuickPartner-setup) + [ ## Datadog 串流預設值 ](#CloudWatch-metric-streams-QuickPartner-Datadog) + [ ## Dynatrace 串流預設值 ](#CloudWatch-metric-streams-QuickPartner-Dynatrace) + [ ## 彈性串流預設值 ](#CloudWatch-metric-streams-QuickPartner-Elastic) + [ ## New Relic 串流預設值 ](#CloudWatch-metric-streams-QuickPartner-NewRelic) + [ ## Splunk 可觀測性雲端串流預設值 ](#CloudWatch-metric-streams-QuickPartner-Splunk) + [ ## Sumo Logic 串流預設值 ](#CloudWatch-metric-streams-QuickPartner-Sumologic) ## 使用快速合作夥伴設定來設定指標串流 CloudWatch 會為某些第三方合作夥伴提供快速設定選項。在開始本節中的步驟之前，您必須先了解合作夥伴的特定資訊。此資訊可能包括您的合作夥伴目的地的目的地 URL 及/或 API 金鑰。您還應閱讀上一節中連結的合作夥伴網站上的文件，以及下列章節中列出的該合作夥伴的預設值。 若要串流至快速設定不支援的第三方目的地，您可遵循[Firehose 的自訂設定](CloudWatch-metric-streams-setup-datalake.md)中的指示，以使用 Firehose 來設定串流，然後將這些指標從 Firehose 傳送至最終目的地。 **使用快速合作夥伴設定來建立到第三方供應商的指標串流** 1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。 1. 在導覽窗格中，選擇 **Metrics** (指標)、**Streams** (串流)。然後選擇 **Create metric stream** (建立指標串流)。 1. (選用) 若您登入的帳戶已設定為 CloudWatch 跨帳戶觀察功能中的監控帳戶，則可以選擇是否在此指標串流中包含來自連結之來源帳戶的指標。若要包含來自來源帳戶的指標，請選擇 **Include source account metrics** (包含來源帳戶指標)。 1. 選擇**快速 Amazon Web Services 合作夥伴設定** 1. 選取您想要串流指標的目標合作夥伴。 1. 針對**端點 URL**，輸入目的地 URL。 1. 針對**存取金鑰**或 **API 金鑰**，輸入合作夥伴的存取金鑰。並非所有合作夥伴都需要存取金鑰。 1. 對於**要串流的指標**，請選擇**所有指標**或**選取指標**。 如果您選擇**所有指標**，此帳戶的所有指標都會包含在串流中。 請仔細考慮是否要串流所有指標，因為串流的指標數量越多，指標串流的費用就越高。 如果您選擇**選取指標**，請執行下列動作之一： + 若要串流大多數指標命名空間，請選擇**排除**，然後選取要排除的命名空間或指標。當您在**排除**中指定命名空間時，可以選擇從該命名空間中選取一些要排除的特定指標。如果您選擇排除某個命名空間，但未在該命名空間中選取指標，則該命名空間中的所有指標都會排除。 + 若只要在指標串流中包含少數指標命名空間，請選擇**包含**，然後選取要包含的命名空間或指標。如果您選擇包含某個命名空間，但未在該命名空間中選取指標，則該命名空間中的所有指標都會包含在內。 1. (選用) 若要為這些指標中的某些指標串流除最小值、最大值、樣本計數和總和之外的額外統計資料，請選擇**新增額外統計資料**。您可以選擇 **Add recommended metrics** (新增建議的指標) 以新增常用統計數字，或手動選取要為其串流額外統計數字的命名空間和指標名稱。然後選取要串流的額外統計數字。 選擇要為其串流不同額外統計數字集的另一組指標，然後選擇 **Add additional statistics** (新增額外統計數字)。每個指標可以包含多達 20 個額外統計數字，而一個指標串流中具有多達 100 個能夠包含額外統計數字的指標。 串流額外統計數字會產生更多費用。如需詳細資訊，請參閱[可供串流的統計數字](CloudWatch-metric-streams-statistics.md)。 如需有關額外統計數字的定義，請參閱 [CloudWatch 統計資料定義](Statistics-definitions.md)。 1. (選用) 在 **Metric stream name** (指標串流名稱) 下，自訂新指標串流的名稱。 1. 選擇 **Create metric stream** (建立指標串流)。 ## Datadog 串流預設值 到 Datadog 的快速合作夥伴設定串流會使用下列預設值： + **輸出格式：**OpenTelemetry 0.7.0 + **Firehose 串流內容編碼** GZIP + **Firehose 串流快取選項** 60 秒間隔時間，大小為 4 MB + **Firehose 串流重試選項** 60 秒持續時間 若您使用快速合作夥伴設定來建立 Datadog 的指標串流，並串流某些指標，這些指標預設會包括一些額外的統計資料。串流額外統計資料會產生額外費用。如需有關統計資料的詳細資訊，請參閱 [可供串流的統計數字](CloudWatch-metric-streams-statistics.md)。 如果您選擇串流這些指標，下列清單將顯示預設會串流其他統計資料的指標。您可以選擇在開始串流之前，取消選取這些額外的統計資料。 + **`AWS/Lambda` 中的 `Duration`：**p50、p80、p95、p99、p99.9 + **`AWS/Lambda` 中的 `PostRuntimeExtensionDuration`：**p50、p99 + **`AWS/S3` 中的 `FirstByteLatency` 和 `TotalRequestLatency`：**p50、p90、p95、p99、p99.9 + **`AWS/Polly` 中的 `ResponseLatency` 和 AWS/ApplicationELB 中的 `TargetResponseTime`：**p50、p90、p95、p99 + **`AWS/ApiGateway` 中的 `Latency` 和 `IntegrationLatency`：**p90、p95、p99 + **`AWS/ELB` 中的 `Latency` 和 `TargetResponseTime`：**p95、p99 + **`AWS/AppRunner` 中的 `RequestLatency`：**p50、p95、p99 + **`AWS/States` 中的 `ActivityTime`、`ExecutionTime`、`LambdaFunctionRunTime`、`LambdaFunctionScheduleTime`、`LambdaFunctionTime`、`ActivityRunTime` 和 `ActivityScheduleTime`：**p95、p99 + **`AWS/MediaLive` 中的 `EncoderBitRate`、`ConfiguredBitRate` 和 `ConfiguredBitRateAvailable`：**p90 + **`AWS/AppSync` 中的 `Latency`：**p90 ## Dynatrace 串流預設值 到 Dynatrace 的快速合作夥伴設定串流會使用下列預設值： + **輸出格式：**OpenTelemetry 0.7.0 + **Firehose 串流內容編碼** GZIP + **Firehose 串流快取選項** 60 秒間隔時間，大小為 5 MB + **Firehose 串流重試選項** 600 秒持續時間 ## 彈性串流預設值 到 Elastic 的快速合作夥伴設定串流會使用下列預設值： + **輸出格式：**OpenTelemetry 1.0.0 + **Firehose 串流內容編碼** GZIP + **Firehose 串流快取選項** 60 秒間隔時間，大小為 1 MB + **Firehose 串流重試選項** 60 秒持續時間 ## New Relic 串流預設值 到 New Relic 的快速合作夥伴設定串流會使用下列預設值： + **輸出格式：**OpenTelemetry 0.7.0 + **Firehose 串流內容編碼** GZIP + **Firehose 串流快取選項** 60 秒間隔時間，大小為 1 MB + **Firehose 串流重試選項** 60 秒持續時間 ## Splunk 可觀測性雲端串流預設值 到 Splunk 可觀測性雲端的快速合作夥伴設定串流會使用下列預設值： + **輸出格式：**OpenTelemetry 1.0.0 + **Firehose 串流內容編碼** GZIP + **Firehose 串流快取選項** 60 秒間隔時間，大小為 1 MB + **Firehose 串流重試選項** 300 秒持續時間 ## Sumo Logic 串流預設值 到 Sumo Logic 的快速合作夥伴設定串流會使用下列預設值： + **輸出格式：**OpenTelemetry 0.7.0 + **Firehose 串流內容編碼** GZIP + **Firehose 串流快取選項** 60 秒間隔時間，大小為 1 MB + **Firehose 串流重試選項** 60 秒持續時間