jacksondavenport/sample-python-app

镜像概述

本镜像用于验证和快速/简单测试Datadog Python Tracer，内置一个小型Flask应用，方便开发和测试环境中验证Datadog APM功能的集成。

核心功能与特性

• 提供小型Flask应用用于生成追踪数据
• 支持通过环境变量配置应用行为
• 兼容Kubernetes环境部署，支持Datadog Agent的Host IP和Socket两种连接方式
• 可配置日志输出路径

使用场景

适用于开发或测试环境中，验证Datadog Python Tracer与Datadog Agent的集成是否正常，快速测试APM追踪功能。

配置说明 - 环境变量

使用方法

Docker运行

基础运行命令：

bash
docker run -p 3000:3000 jacksondavenport/sample-python-app:latest

自定义端口和日志路径：

bash
docker run -p 8080:8080 -e PORT=8080 -e LOG_PATH=/var/log/app/example.log jacksondavenport/sample-python-app:latest

Kubernetes部署

Host IP模式

适用于通过主机IP连接Datadog Agent的场景：

yaml
apiVersion: v1
kind: Pod
metadata:
    name: python-apm
    labels:
      app: python-apm
spec:
    containers:
        - name: sample-python-app
          image: jacksondavenport/sample-python-app:latest
          imagePullPolicy: Always
          env:
            - name: DD_AGENT_HOST
              valueFrom:
                fieldRef:
                  fieldPath: status.hostIP
            #- name: DD_TRACE_DEBUG
            #  value: "true"

Socket模式

注意：使用Datadog Helm Chart v2.21.0+可默认启用APM Socket

yaml
apiVersion: v1
kind: Pod
metadata:
    name: python-apm
    labels:
      app: python-apm
spec:
    containers:
        - name: sample-python-app
          image: jacksondavenport/sample-python-app:latest
          imagePullPolicy: Always
          env:
            - name: DD_TRACE_AGENT_URL
              value: "unix:/var/run/datadog/apm.socket"
            #- name: DD_TRACE_DEBUG
            #  value: "true"
          volumeMounts:
            - name: apmsocket
              mountPath: /var/run/datadog
    volumes:
      - hostPath:
          path: /var/run/datadog/
        name: apmsocket

测试方法

部署后可通过访问Flask应用测试追踪功能：

bash
kubectl exec -it python-apm -- curl http://localhost:3000

该请求将生成追踪数据并发送至运行中的Datadog Agent，可在Datadog控制台查看追踪结果。