Datadog Agent

当前存储库包含 Datadog 代理版本 7 和版本 6 的源代码。有关代理 v5、代理 v6 和代理 v7 之间差异的信息，请参阅代理用户文档。此外，我们在此处提供了一个预打包二进制文件列表，以便于安装过程

注意： Datadog Agent v5 的源代码位于 dd-agent存储库中。

文档

该项目的一般文档，包括安装和开发说明，位于当前 repo的 docs 目录下。

入门

要构建代理，您需要：

• Go1.18 或更高版本。你还需要在你的路径中设置你的 $GOPATH和拥有的。$GOPATH/bin
• Python 3.7+ 以及用于工具的开发库。如果您要构建支持 Python 2 的代理，您还需要 Python 2.7。
• Python 依赖项。您可以安装这些，如果尚未安装，pip install -r requirements.txt 这也会拉入Invoke 。
• CMake 版本 3.12 或更高版本以及 C++ 编译器

注意： 您可能希望使用 python 虚拟环境来避免代理构建/开发依赖项污染系统范围的 python 环境。您可以使用创建虚拟环境 virtualenv，然后使用 invoke agent.build 参数 --python-home-2=<venv_path>和/或 --python-home-3=<venv_path> （取决于您使用的 python 版本）来使用虚拟环境的解释器和库。默认情况下，此环境仅用于 requirements.txt.

注意： 您之前可能 invoke在 MacOS 或 pip任何其他平台上通过 brew 安装过。我们建议您使用固定在需求文件中的版本以获得流畅的开发/构建体验。

构建和测试使用, 在 shell 上 invoke键入 invoke --list以查看可用任务。

要开始使用代理，您可以构建 main分支：

1. 签出回购：git clone https://github.com/DataDog/datadog-agent.git $GOPATH/src/github.com/DataDog/datadog-agent。

2. cd 进入项目文件夹：cd $GOPATH/src/github.com/DataDog/datadog-agent.

3. 安装 go 工具：invoke install-tools.

4. 在 中创建一个开发 datadog.yaml配置文件 dev/dist/datadog.yaml，其中包含一个有效的 API 密钥：api_key: <API_KEY>

5. 使用 构建代理 invoke agent.build --build-exclude=systemd。 默认情况下，代理将被构建为使用 Python 3，但您可以选择要使用的 Python 版本：

   • invoke agent.build --python-runtimes 2仅适用于 Python2
   • invoke agent.build --python-runtimes 3仅适用于 Python3
   • invoke agent.build --python-runtimes 2,3对于 Python2 和 Python3

   您可以为代理指定自定义 Python 位置（在使用 virtualenvs 时很有用）：

   invoke agent.build \
     --python-runtimes 2,3 \
     --python-home-2=$GOPATH/src/github.com/DataDog/datadog-agent/venv2 \
     --python-home-3=$GOPATH/src/github.com/DataDog/datadog-agent/venv3 .

   运行 invoke agent.build：

   • 放弃在 中所做的任何更改 bin/agent/dist。
   • 构建代理并将二进制文件写入 bin/agent/agent.
   • 将文件从 复制 dev/dist到 bin/agent/dist。有关 https://github.com/DataDog/datadog-agent/blob/main/dev/dist/README.md更多信息，请参阅。

   如果您构建了较旧版本的代理，您可能会遇到错误 make: *** No targets specified and no makefile found. Stop.。要解决此问题，您应该 CMakeCache.txt从 rtloader文件夹中删除 rm rtloader/CMakeCache.txt. 请注意，跟踪代理需要单独构建和运行。

有关详细信息，请参阅代理开发人员指南。有关设置 Windows 开发环境的说明，请参阅Windows 开发环境。

测试

使用 invoke test. 在开发过程中，添加 --skip-linters直接跳到测试的选项。

invoke test --targets=./pkg/aggregator/... --skip-linters

在测试依赖于rtloader的代码时，首先构建并安装它。

invoke rtloader.make && invoke rtloader.install
invoke test --targets=./pkg/collector/python --skip-linters

Run

您可以使用以下方式运行代理：

./bin/agent/agent run -c bin/agent/dist/datadog.yaml

该文件 bin/agent/dist/datadog.yaml由 复制而来 dev/dist/datadog.yaml，invoke agent.build并且必须包含有效的 api 密钥。

贡献代码

您将在当前 repo的 docs/dev目录下找到有关如何为该项目贡献代码的信息和帮助 。

执照

Datadog 代理用户空间组件在 Apache 许可证 2.0 版下获得许可。BPF 代码根据通用公共许可证 2.0 版获得许可。