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

# Firehose 的自訂設定
<a name="CloudWatch-metric-streams-setup-datalake"></a>

使用此方法來建立指標串流，然後將其引導至 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 主控台
<a name="CloudWatch-metric-streams-setup-datalake-console"></a>

本節會描述如何透過 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
<a name="CloudWatch-metric-streams-setup-datalake-CLI"></a>

使用下列步驟，建立 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
<a name="CloudWatch-metric-streams-setup-datalake-CFN"></a>

您可以使用 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)
<a name="CloudWatch-metric-streams-setup-datalake-CDK"></a>

您可以使用 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)。