部署Datadog Airflow集成报错Check not found in Catalog如何排查

这个报错的核心原因是集群Agent本地未安装Airflow对应的集成检查包，提示里的Catalog指的是Agent启动时扫描本地已安装集成生成的可用检查清单，和配置文件语法、权限没有直接关系，是容器化部署Datadog集成时非常常见的踩坑点。

可直接落地的解决步骤 #

• 给集群Agent安装Airflow集成包
  默认的Datadog集群Agent镜像为了控制体积，只内置了K8s核心组件相关的基础集成，Airflow属于独立维护的第三方集成，不会默认预装。如果用Helm部署，直接在values.yaml里添加如下配置即可自动完成集成安装：

  clusterAgent:
    installIntegrations:
      airflow:
        enabled: true
        version: latest
  

  如果是自定义构建Agent镜像，在Dockerfile里添加一行构建命令即可：

  RUN agent integration install datadog-airflow==<匹配你Airflow版本的集成版本号>
  

• 修正confd配置的挂载路径
  Agent读取自定义集成配置的固定路径规则是/etc/datadog-agent/conf.d/<集成名>.d/conf.yaml，你需要把之前准备的airflow.yaml重命名为conf.yaml，放到airflow.d目录下再挂载进容器，直接把配置文件扔到confd根目录不会被Agent识别。
  挂载完成后可以进集群Agent容器执行datadog-cluster-agent configcheck，如果输出里能正常识别到Airflow的配置实例、没有路径/权限报错，就说明配置挂载正确。
• 重启集群Agent Pod等待配置生效，重新执行datadog-cluster-agent status验证，正常情况下Running Checks段会显示Airflow检查的采集实例数、最近采集时间，不会再出现not found的报错。

调试日志获取与日志级别调整方法 #

如果按上面步骤操作后还是异常，可以通过下面的方式拿更详细的日志定位问题：

• 临时开全局trace级日志：进集群Agent容器执行datadog-cluster-agent config set log_level trace，不需要重启Pod，Agent会立刻打印从集成加载、配置解析到检查执行的全链路日志，直接看容器标准输出即可，排查完执行datadog-cluster-agent config set log_level info恢复默认日志级别避免日志量暴涨。
• 定向开check加载模块的debug日志：不想全局开trace的话，可以在Helm values里加环境变量，只给检查加载模块开高日志级别：

  clusterAgent:
    env:
      - name: DD_LOG_LEVEL
        value: "info"
      - name: DD_LOG_LEVEL_CHECKS
        value: "debug"
      - name: DD_LOG_LEVEL_LOADER
        value: "trace"
  

• 直接查看Agent运行日志：所有检查的执行报错、异常栈都会存在容器内的/var/log/datadog/agent.log文件里，直接grep airflow关键词就能过滤出所有和Airflow集成相关的详细报错，比status命令的笼统提示信息全很多，常见的连接超时、认证失败、指标格式不兼容等问题都能在这个日志里找到明确原因。

内容的提问来源于stack exchange，提问作者felipecgonc