개요

Datadog 에이전트는 Gunicorn에 대한 하나의 주요 메트릭, 즉 실행 중인 작업자 프로세스의 수를 수집합니다. 또한 Gunicorn이 실행 중인지 여부에 대한 서비스 점검 정보를 전송합니다.

Gunicorn 자체에서 DogStatsD를 사용하여 다음을 포함한 메트릭을 추가로 제공할 수 있습니다:

• 총 요청 비율
• 상태 코드별 요청 비율(2xx, 3xx, 4xx, 5xx)
• 요청 기간(평균, 중앙값, 최대, 95번째 백분위수 등)
• 로그 수준(심각, 오류, 경고, 예외)별 로그 메시지 비율

설정

설치

Datadog Agent Gunicorn 점검은 Datadog Agent 패키지에 포함되어 있으므로 Gunicorn 서버에 별도로 설치할 필요가 없습니다.

Gunicorn 점검을 사용하려면 Gunicorn 앱의 Python 환경에 setproctitle 패키지가 있어야 합니다. 없는 경우 Datadog Agent는 gunicorn 마스터 프로세스를 찾을 수 없다고 보고합니다(따라서 작업자도 찾을 수 없음). gunicorn.workers 메트릭을 수집하려면 앱의 Python 환경에 setproctitle 패키지를 설치하세요.

설정

Gunicorn 메트릭 및 로그 수집을 시작하려면 Agent 설정 디렉터리의 루트에 있는 conf.d/ 폴더에서 gunicorn.d/conf.yaml 파일을 편집합니다. 모든 가용 설정 옵션을 보려면 샘플 gunicorn.yaml을 참조하세요.

메트릭 수집

Gunicorn을 DogStatsD에 연결

1. 버전 19.1부터 Gunicorn은 DogStatsD과 마찬가지로 StatsD 프로토콜을 구현하는 Daemon에 메트릭을 전송하는 옵션을 제공합니다. 다른 많은 Gunicorn 옵션과 같이 CLI에서 gunicorn(--statsd-host)로 전달하거나 앱의 설정 파일(statsd_host)에서 설정할 수 있습니다. 모든 Gunicorn 메트릭을 수집하려면 "localhost:8125"에서 DogStatsD로 메트릭을 전송하도록 앱을 설정합니다. 그런 다음 앱을 다시 시작하세요.

2. gunicorn.d/conf.yaml 파일에 설정 블록을 추가하여 Gunicorn 메트릭 수집을 시작하세요.

init_config:

instances:
    ## @param proc_name - string - required
    ## The name of the gunicorn process. For the following gunicorn server:
    ##
    ## gunicorn --name <WEB_APP_NAME> <WEB_APP_CONFIG>.ini
    ##
    ## the name is `<WEB_APP_NAME>`
  - proc_name: <YOUR_APP_NAME>

3. Agent를 다시 시작하여 Gunicorn 메트릭을 Datadog으로 전송합니다.

로그 수집

에이전트 버전 > 6.0에서 사용 가능

1. 로그 수집은 Datadog 에이전트에서 기본적으로 비활성화되어 있습니다. datadog.yaml 파일에서 활성화합니다.

   logs_enabled: true
   

2. 다음 명령을 사용하여 액세스 로그 파일의 경로를 설정합니다. --access-logfile <MY_FILE_PATH>

3. 다음 명령을 사용하여 에러 로그 파일의 경로를 설정합니다. --error-logfile FILE, --log-file <MY_FILE_PATH>

4. 이 설정 블록을 gunicorn.d/conf.yaml 파일에 추가하여 Gunicorn 로그 수집을 시작하세요.

   logs:
     - type: file
       path: /var/log/gunicorn/access.log
       service: "<MY_SERVICE>"
       source: gunicorn
   
     - type: file
       path: /var/log/gunicorn/error.log
       service: "<MY_SERVICE>"
       source: gunicorn
       log_processing_rules:
         - type: multi_line
           name: log_start_with_date
           pattern: \[\d{4}-\d{2}-\d{2}
   

   service 및 path 파라미터 값을 변경하고 환경에 맞게 설정합니다. 모든 가용 설정 옵션은 샘플 gunicorn.yaml을 참조하세요.

5. Agent를 다시 시작합니다.

검증

Agent 상태 하위 명령을 실행하고 Checks 섹션에서 gunicorn을 찾습니다.

상태가 OK가 아닌 경우 트러블슈팅 섹션을 참조하세요.

netstat을 사용하여 Gunicorn이 자체 메트릭도 전송하는지 확인합니다:

sudo netstat -nup | grep "127.0.0.1:8125.*ESTABLISHED"
udp 0 0 127.0.0.1:38374 127.0.0.1:8125 ESTABLISHED 15500/gunicorn: mas

수집한 데이터

Metrics

이벤트

Gunicorn 점검은 이벤트를 포함하지 않습니다.

서비스 점검

gunicorn.is_running

Agent가 Gunicorn 마스터 프로세스를 찾을 수 없는 경우 CRITICAL이 반환되며, 그 외 경우에는 OK가 반환됩니다.

상태: ok, critical

트러블슈팅

에이전트가 Gunicorn 프로세스를 찾을 수 없습니다.

  Checks
  ======

    gunicorn (5.12.1)
    -----------------
      - instance #0 [ERROR]: 'Found no master process with name: gunicorn: master [my_web_app]'
      - Collected 0 metrics, 0 events & 1 service check
      - Dependencies:
          - psutil: 4.4.1

Gunicorn이 실제로 실행되고 있지 않거나 앱의 파이썬(Python) 환경에 setproctitle 패키지가 설치되어 있지 않습니다.

setproctitle이 설치되어 있지 않으면 프로세스 표에 Gunicorn이 다음과 같이 표시됩니다.

$ ps -ef | grep gunicorn
ubuntu   18013 16695  2 20:23 pts/0    00:00:00 /usr/bin/python /usr/bin/gunicorn --config test-app-config.py gunicorn-test:app
ubuntu   18018 18013  0 20:23 pts/0    00:00:00 /usr/bin/python /usr/bin/gunicorn --config test-app-config.py gunicorn-test:app
ubuntu   18019 18013  0 20:23 pts/0    00:00:00 /usr/bin/python /usr/bin/gunicorn --config test-app-config.py gunicorn-test:app

설치되어_있는_경우 gunicorn 프로세스가 Datadog 에이전트에서 예상한 형식대로 표시됩니다.

$ ps -ef | grep gunicorn
ubuntu   18457 16695  5 20:26 pts/0    00:00:00 gunicorn: master [my_app]
ubuntu   18462 18457  0 20:26 pts/0    00:00:00 gunicorn: worker [my_app]
ubuntu   18463 18457  0 20:26 pts/0    00:00:00 gunicorn: worker [my_app]

참고 자료

• Datadog으로 Gunicorn 성능 모니터링