--- title: "将 Cato 数据与 Datadog 集成" slug: "integrating-cato-data-with-datadog" updated: 2026-10-23T23:17:26Z published: 2026-10-23T23:17:26Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-datadog" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # 将 Cato 数据与 Datadog 集成 ## 概览 Datadog 集成使您可以在 Datadog 中将 Cato 的网络和安全性数据与其他来源的数据一起分析。您可以在不用部署额外的数据收集机制的情况下使用这些数据进行仪表板、监控、警报和日志分析。 Cato 将标准化的事件和可选的网络流直接发送到您的 Datadog 账户。您可以在 Cato 管理应用程序 (CMA) 中配置原生的 Datadog 集成。 ### Datadog 数据来源 您可以配置集成以发送 **事件**、**流量** 或两者。 - **事件:** - 当网络或系统中发生特定活动时生成(例如:策略规则匹配或检测到威胁)。 - 提供离散、实时的安全性和策略执行洞察。 - 使用 Cato 的事件架构发送。 - **新集成默认仅导出事件。** - 事件支持过滤。 - **流量:** - 源自网络流量(5元组),通过 Cato 引擎的应用级信息进行丰富。 - 包含应用程序和用户上下文,以及汇总的会话数据:字节、数据包和持续时间。 - 可能生成比事件更高的数据量。确切的量取决于流量。 ### 条件 在配置此集成前,请确保以下几点: - 您在 CMA 的 资源 部分中具有 集成 的 编辑者 权限。查看 [使用 RBAC 管理管理员权限](/v1/docs/managing-admin-roles-using-rbac)。 - 您已查看 [事件集成入门](/v1/docs/getting-started-with-event-integrations) 中所有 Cato 事件集成的先决条件。 - 您有一个Datadog账户,且拥有创建API密钥的权限。 - 您拥有 **Datadog 站点** 的网址(例如:`datadoghq.com`,`datadoghq.eu`)。 ## 使用实例 ### 事件 您可以发送 Cato 事件到 Datadog,以集中管理安全监控和可观测性。这些事件提供关于网络活动、威胁、用户、设备及通过 Cato 平台的流量的数据。 SOC 和 NOC 团队可以将这些数据纳入现有的监控和调查工作流程。 ### 流量 在调查可疑活动时,您可以使用汇总的流量数据为 Cato 事件添加网络上下文。事件显示如策略决策、用户身份和应用程序的信息。流量数据添加了诸如总传输字节数、数据包计数和会话持续时间等详细信息。 此附加上下文帮助您区分最小活动和可能导致数据外泄的大量数据传输。 ## 创建 Datadog 集成 为了将 Cato 事件和流量发送到 Datadog,您需要在 CMA中使用来自 Datadog 的 API 密钥创建一个集成。 ### 步骤 1:获取 Datadog API 密钥 1. 登录您的 Datadog 账户。 2. 导航到 **组织设置** > **API 密钥**。 3. 点击 **新密钥**,输入描述性名称(例如,`Cato 集成`),然后点击 **创建密钥**。 4. 复制并保存 **API 密钥** 的值。它将不再显示。 5. 记下您的 **Datadog 站点**(可在网址中看到,例如:`datadoghq.com`)。 ### 步骤 2:用curl进行测试 在 CMA 中配置集成前,通过从命令行直接发送测试日志来验证您的 Datadog API 密钥和采集端点是否工作。在接触 CMA 前,这会隔离任何供应商端问题(认证、端点、有效负载验收)。 Datadog Logs 采集 API 使用 `DD-API-KEY` 标头进行认证。 Cato 将 `source` 字段设置为 `cato`,并使用 `data_source` 标签在 Datadog 日志浏览器中区分事件与流量。 **示例— Datadog(美国站点):** 在交互式**Bash** shell中运行整个示例(如有需要先运行`bash`)。在隐藏的提示处输入凭证;不要将其插入到命令中。该示例禁用shell跟踪,并通过标准输入使用`--header @-`传递认证头,保持凭证不出现在shell历史记录和curl命令行参数中。示例完成时会丢弃临时凭证变量。 ```bash (  set +axv  set -euo pipefail  unset CATO_TEST_API_KEY  IFS= read -r -s -p 'Datadog API密钥: ' CATO_TEST_API_KEY  builtin printf '\n' >&2  case "$CATO_TEST_API_KEY" in    ''|*$'\r'*) builtin printf '请输入非空凭证,不要包含回车符。\n' >&2; exit 1 ;;  esac  builtin printf '%s\n' "DD-API-KEY: ${CATO_TEST_API_KEY}" | \    curl -q -X POST "https://http-intake.logs.datadoghq.com/v1/input" \  --header @- \  -H "Accept: application/json" \  -H "Content-Type: application/json" \  -d '[    {      "ddsource": "cato",      "ddtags": "env:staging,version:5.1",      "message": { "message":"来自curl的测试事件","event_type":"测试","timestamp":"2026-07-05T12:00:00Z" }    }  ]' ) ``` 1. 使用与您的Datadog站点匹配的摄取URL,并在隐藏提示处输入步骤1中获取的API密钥。 成功的响应会返回 HTTP `202 Accepted`。 2. 验证日志是否显示在 Datadog 中的 **Logs** > **Search** 下,并通过 `source:cato` 进行过滤。 ### 步骤 3:在 CMA 中配置集成 1. 从 CMA 的导航菜单中,转到 **资源** > **集成**。 2. 打开 **配置的集成** 标签页,然后点击 **新建**。 3. 在 **新集成** 面板中,从集成下拉列表中选择 **Datadog**。 4. **能力** 自动设置为 **数据导出**。 5. 在 **身份验证** 下拉菜单中,选择 **Datadog 的 API 密钥认证**。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(254).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A24%3A47Z&se=2026-11-19T06%3A24%3A47Z&sr=b&sp=r&sig=XIVCUMWd9%2FwyYfmOP9ISmwIZLrvpDf3irBy3Ge9wbk0%3D) 6. 为集成输入一个 **名称**(必填项)。 7. 可选地,输入 **描述**。 8. 输入 **Datadog 站点** (例如:`datadoghq.com`)。 9. 输入从 Datadog 复制的 **API 密钥**。 10. 在**数据来源**下,选择**事件**、**流量**或两者。 11. 如果需要,可配置 **事件过滤器** 和/或 **流量过滤器** 组,以控制发送哪些数据(请参阅下面的过滤器)。 12. 点击 **保存**。 13. 刷新集成页面。集成将在 **已配置的集成** 表中显示为 **已连接** 状态。 ## 过滤器 过滤器让您控制哪些 Cato 事件(和流量)被导出到 Datadog。 - 有助于降低采集成本、减少噪音并集中调查。 - 允许将事件的不同子集路由到不同平台。 - 基于任何 **事件字段** 或字段组合定义过滤器组。 - 每个组内的条件使用 **AND** 逻辑;组之间使用 **OR** 逻辑。 ### 事件过滤器 在 **新集成** 面板下的 **事件过滤器** 中可用。点击 **添加过滤器** 以定义条件,或点击 **添加组** 以创建附加过滤器组(组之间的 OR 逻辑)。 ### 流量过滤器 当选择流量作为数据来源时,在 **流量过滤器** 下可用。遵循事件过滤器的相同逻辑。 ## 故障排查 | 问题 | 解决方案 | | --- | --- | | 集成显示 **连接错误** | 验证是否正确输入了 Datadog 站点网址和 API 密钥。确保 API 密钥在 Datadog 中未被撤销。 | | Datadog 中没有事件到达 | 检查您的事件过滤器配置 - 过于精确的过滤器可能会静默排除所有数据。 | | Datadog 中没有流量到达 | 确认在数据来源下选择了 **流量**,并检查流量过滤器是否有过于限制的条件。 | | 集成已保存但状态未显示 **已连接** | 刷新集成页面。如果问题仍然存在,请验证您的 Datadog API 密钥权限。 |