Datadog 简介

Datadog是一个云监控即服务解决方案，通过基于SaaS的数据分析平台，为云规模的应用提供监控服务器、数据库、工具和服务。截至2021年第一季度（来源），超过15000个客户使用Datadog进行分布式监控和安全。

随着应用开发的复杂度增加，监控成为了应用的一个重要组成部分。及时、准确的监控既能满足快速迭代的周期性需求，又能够确保应用的稳定性和流畅性。如何选择一个适合的监控，以提升应用的可观测性，成为了每个开发者都必须面临的一道难题。

Apache APISIX 将监控和可观测性从应用中解耦了出来，给开发人员带来了一个优势：在构建应用的时候，只需要关注业务逻辑，而 Apache APISIX 可以和开发人员选定的监控平台对接，处理可观测性的问题。

Apache APISIX 最近发布了一个新的插件：APISIX-Datadog，以提供与 Datadog 监控平台的集成。这篇文章介绍了 APISIX-Datadog 插件的实现原理及功能。

APISIX-Datadog plugin 工作原理

当你启用 APISIX-Datadog 插件时，Apache APISIX agent 会在每个请求响应周期向 DogStatsD server 输出以下指标：

这些指标将被发送到 DogStatsD agent，并带有以下标签。如果任何特定的标签没有合适的值，该标签将被直接省略。

APISIX-Datadog 插件维护了一个带有 timer 的buffer。当 timer 失效时，APISIX-Datadog 插件会将 buffer 的指标作为一个批量处理程序传送给本地运行的 DogStatsD server。这种方法通过重复使用相同的 UDP 套接字，对资源的占用较少，而且由于可以配置 timer，所以不会一直让网络过载。

启动 Datadog Agent

1. 如果你已经在使用 Datadog，你必须在系统中安装一个 Datadog agent。它可以是一个 docker 容器，一个 pod 或二进制的包管理器。你只需要确保 Apache APISIX agent 可以到达 Datadog agent 的 8125 端口。

2. 如果你从没使用过 Datadog

• 首先访问http://www.datadoghq.com，创建一个账户。
• 然后按照下面演示的步骤生成一个API密钥。

3. APISIX-Datadog 插件只需要依赖 datadog/agent 的 dogstatsd 组件即可实现，因为该插件按照 statsd 协议通过标准的 UDP 套接字向 dogstatsd server 异步发送参数。我们推荐使用独立的 datadog/dogstatsd 镜像，而不是使用完整的datadog/agent ，因为 datadog/dogstatsd 的组件大小只有大约 11 MB，更加轻量化。而完整的 datadog/agent 镜像的大小为 2.8 GB。

运行以下命令，将它作为一个容器来运行：

如果你在生产环境中使用 Kubernetes，你可以将 dogstatsd 作为一个 Daemonset 或多容器 Pod 与 Apache APISIX agent 一起部署。

如何在 Apache APISIX 中使用 Datadog

启用 APISIX-Datadog 插件

dogstatsd/agent

/hello

自定义配置

127.0.0.1:8125

元数据参数解释

/apisix/admin/plugin_metadata

插件参数解释

与元数据类似，在启用 APISIX-Datadog 插件时，你也可以调整其他参数。

batch_max_size

停用 APISIX-Datadog 插件

你只需在插件配置中删除相应的 json 配置即可停用 APISIX-Datadog 插件。由于 Apache APISIX 插件是热加载的，因此删除 json 配置后，会立即停用 APISIX-Datadog 插件，不需要重新加载。

关于 Apache APISIX

Apache APISIX 是一个动态、实时、高性能的开源 API 网关，提供负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。Apache APISIX 可以帮助企业快速、安全地处理 API 和微服务流量，包括网关、Kubernetes Ingress 和服务网格等。