SuperAPI AI 工具集

configuring-log-export

数据与分析

查看项目

更新于 10-15 20:13

技能介绍

用途:为 CockroachDB Cloud 集群配置日志与指标导出,将集群日志、审计日志和性能指标投递到外部监控服务,支持 AWS CloudWatch、GCP Cloud Logging 及 Datadog。

主要能力:设置日志导出到 CloudWatch 或 GCP Cloud Logging;配置指标导出到 CloudWatch 或 Datadog;验证 SQL 审计日志是否导出到外部接收端;排查导出错误或日志缺失;估算日志量对应的成本;通过 Terraform 配置导出。

前提条件:需 Advanced 计划(Basic/Standard 不支持日志导出);ccloud CLI 已认证且具 Cluster Admin 角色;AWS 需创建 CloudWatch 日志组并配置跨账户 IAM 角色,GCP 需启用 Cloud Logging API 并授予服务账号 Logs Writer 角色;集群 ID 可通过 ccloud cluster list 获取。可用 ccloud auth whoami 与 ccloud cluster info <cluster-name> -o json 确认访问权限和计划。

使用方式:先确定日志与指标导出目标,再按对应步骤操作。日志导出到 CloudWatch 需创建日志组、设置保留策略、创建 IAM 角色,然后执行 ccloud cluster log-export create <cluster-id> --log-group-name cockroachdb-<cluster-name> --auth-principal <iam-role-arn> --type AWS_CLOUDWATCH --region <aws-region>。GCP 需启用 logging.googleapis.com、授予 roles/logging.logWriter,再执行 ccloud cluster log-export create <cluster-id> --auth-principal <gcp-project-id> --type GCP_CLOUD_LOGGING。指标导出到 CloudWatch 使用 ccloud cluster metric-export create cloudwatch <cluster-id> --role-arn <iam-role-arn> --target-region <aws-region>;到 Datadog 使用 ccloud cluster metric-export create datadog <cluster-id> --api-key <datadog-api-key> --site <datadog-site>。可用 ccloud cluster log-export list <cluster-id> -o json 和 ccloud cluster metric-export list <cluster-id> -o json 验证状态。

适用场景:集群日志集中监控、审计日志外送、指标接入现有监控体系、成本估算与故障排查。

限制与注意:日志导出仅 Advanced 计划可用;IAM 配置错误会导致导出静默失败;高流量集群可能产生显著日志费用,建议设置保留策略;启用审计日志会大幅增加日志量;Terraform 中同时创建集群、日志导出与 CMEK 可能触发竞态条件,应先创建集群再单独应用导出配置;重新启用导出不会补发历史日志。回滚可执行 ccloud cluster log-export delete <cluster-id> 及对应 metric-export delete 命令。