View a markdown version of this page

將 CloudWatch 指標與 Amazon Managed Service for Prometheus 整合 - Amazon Managed Service for Prometheus
基礎設施建立 Amazon CloudWatch 串流清除

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

將 CloudWatch 指標與 Amazon Managed Service for Prometheus 整合

這有助於將您的所有指標集中在一個位置。Amazon Managed Service for Prometheus 不會自動擷取 Amazon CloudWatch 指標。不過，您可以使用 Amazon Data Firehose 和 AWS Lambda 將 CloudWatch 指標推送至 Amazon Managed Service for Prometheus。

本節說明如何檢測 Amazon CloudWatch 指標串流，並使用 Amazon Data Firehose 和 AWS Lambda將指標擷取至 Amazon Managed Service for Prometheus。

您將使用AWS 雲端開發套件 (CDK) 設定堆疊來建立 Firehose 交付串流、Lambda 和 Amazon S3 儲存貯體，以示範完整的案例。

基礎設施

您必須做的第一件事是為此配方設定基礎設施。

CloudWatch 指標串流允許將串流指標資料轉送到 HTTP 端點或 Amazon S3 儲存貯體。

設定基礎設施將包括 4 個步驟：

  • 設定先決條件

  • 建立 Amazon Managed Service for Prometheus 工作區

  • 安裝相依項目

  • 部署堆疊

先決條件

建立 Amazon Managed Service for Prometheus 工作區

  1. 此配方中的示範應用程式將在 Amazon Managed Service for Prometheus 最上方執行。透過下列命令建立 Amazon Managed Service for Prometheus 工作區：

    aws amp create-workspace --alias prometheus-demo-recipe

  2. 確定已使用下列命令建立您的工作區：

    aws amp list-workspaces

    如需有關 Amazon Managed Service for Prometheus 的詳細資訊，請參閱 Amazon Managed Service for Prometheus 使用者指南。

安裝相依項目

  1. 安裝相依項目

    從 aws-o11y-recipes 儲存庫的根目錄中，使用以下命令將目錄變更為 CWMetricStreamExporter：

    cd sandbox/CWMetricStreamExporter

    現在，這將視為儲存庫的根目錄，以後也是。

  2. 透過下列命令將目錄變更為 /cdk：

    cd cdk

  3. 執行以下命令以安裝 CDK 相依項目：

    npm install

  4. 將目錄變更回儲存庫的根目錄，然後使用以下命令將目錄變更為 /lambda：

    cd lambda

  5. 一旦進入 /lambda 資料夾後，使用以下命令安裝 Go 相依項目：

    go get

    現在已安裝所有相依項目。

部署堆疊

  1. 在儲存庫的根目錄中，開啟 config.yaml 並修改 Amazon Managed Service for Prometheus 工作區 URL，方法是將 {workspace} 替換為新建立的工作區 ID ，以及您 Amazon Managed Service for Prometheus 工作區所在的區域。

    例如，將以下項目修改為：

    AMP: 
    remote_write_url: "https://aps-workspaces.us-east-2.amazonaws.com/workspaces/{workspaceId}/api/v1/remote_write" 
    region: us-east-2

    將 Firehose 交付串流和 Amazon S3 儲存貯體的名稱變更為喜歡的名稱。

  2. 若要建置 AWS CDK 和 Lambda 程式碼，請在儲存庫的根目錄中執行下列命令：

    npm run build

    此建立步驟可確保建立 Go Lambda 二進制文件，並將 CDK 部署到 CloudFormation。

  3. 若要完成部署，請檢閱並接受堆疊所需的 IAM 變更。

  4. (選用) 若已透過執行下列命令建立堆疊，則可有所變化。

    aws cloudformation list-stacks

    名為 CDK Stack 的堆疊將會在清單中。

建立 Amazon CloudWatch 串流

既然您有處理指標的 lambda 函數，您可自 Amazon CloudWatch 建立指標串流。

建立 CloudWatch 指標串流

  1. 導覽至 CloudWatch 主控台，網址為 https://console.aws.amazon.com/cloudwatch/home#metric-streams:streamsList，然後選取建立指標串流。

  2. 選取所需指標，可以是所有指標，或僅從所選命名空間選取。

  3. 在 Configuration 下方，選擇選取您帳戶擁有的現有 Firehose。

  4. 您將會使用 CDK 先前建立的 Firehose。在選取您的 Kinesis 資料 Firehose 串流下拉式清單中，選取先前建立的串流。名稱將會像是 CdkStack-KinesisFirehoseStream123456AB-sample1234。

  5. 將輸出格式變更為 JSON。

  6. 為指標串流賦予對您有意義的名稱。

  7. 選擇 Create metric stream (建立指標串流)。

  8. (選用) 若要驗證 Lambda 函數調用，請導覽至 Lambda 主控台並選擇函數 KinesisMessageHandler。選取監控索引標籤和日誌子索引標籤，在最近的調用下應該會有要觸發的 Lambda 函數輸入項。

    注意

    最多可能需要 5 分鐘才會開始在監控索引標籤中顯示調用。

您的指標現已從 Amazon CloudWatch 串流到 Amazon Managed Service for Prometheus。

清除

您可能想要清除本範例中使用的資源。下列程序說明如何執行此作業。這會停止您建立的指標串流。

清理資源

  1. 首先，請使用下列命令刪除 CloudFormation 堆疊：

    cd cdk
cdk destroy

  2. 移除 Amazon Managed Service for Prometheus 工作區：

    aws amp delete-workspace --workspace-id \
    `aws amp list-workspaces --alias prometheus-sample-app --query 'workspaces[0].workspaceId' --output text`

  3. 最後，使用 Amazon CloudWatch 主控台移除 Amazon CloudWatch 指標串流。