호스트

호스트에서 실행 중인 에이전트에 대해 이 점검을 구성하려면:

메트릭 수집

1. 에이전트 설정 디렉토리의 루트에 있는 conf.d/ 폴더에서 redisdb.d/conf.yaml 파일을 편집합니다. 다음 파라미터를 업데이트해야 할 수도 있습니다. 사용 가능한 모든 설정 옵션은 redisdb.d/conf.yaml 샘플을 참조하세요.

   init_config:
   instances:
     ## @param host - string - required
     ## Enter the host to connect to.
     - host: localhost
       ## @param port - integer - required
       ## Enter the port of the host to connect to.
       port: 6379
   
       ## @param username - string - optional
       ## The username to use for the connection. Redis 6+ only.
       #
       # username: <USERNAME>
   
       ## @param password - string - optional
       ## The password to use for the connection.
       #
       # password: <PASSWORD>
   

2. Redis 6+ 및 ACL을 사용한다면 사용자에게 최소 데이터베이스 수준 DB Viewer 권한, 클러스터 환경에서 작동하는 경우 Cluster Viewer 권한, +config|get +info +slowlog|get ACL 규칙이 있는지 확인하세요. 자세한 내용은 데이터베이스 액세스 제어를 참조하세요.

3. 에이전트를 재시작합니다.

로그 수집

Agent 버전 6.0 이상에서 사용 가능

1. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml파일에서 로그 수집을 사용하도록 설정합니다.

   logs_enabled: true
   

2. redisdb.d/conf.yaml의 하단에서 이 설정 블록의 주석 처리를 제거하고 편집합니다.

   logs:
     - type: file
       path: /var/log/redis_6379.log
       source: redis
       service: myapplication
   

   path와 service 파라미터 값을 내 환경에 맞게 변경 및 설정하세요. 사용할 수 있는 설정 옵션 전체를 보려면 redisdb.yaml 샘플을 참고하세요.

3. 에이전트를 재시작합니다.

트레이스 수집

Datadog APM은 Redis와 통합되어 분산 시스템 전체의 트레이스를 확인합니다. Datadog 에이전트 v6+에서는 트레이스 수집이 기본적으로 활성화되어 있습니다. 트레이스 수집을 시작하려면 다음 지침을 따르세요.

1. Datadog에서 트레이스 수집을 활성화합니다.
2. Redis에 요청하는 애플리케이션을 계측합니다.

도커(Docker)

컨테이너에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에 자동탐지 통합 템플릿을 Docker 레이블로 설정하세요.

LABEL "com.datadoghq.ad.check_names"='["redisdb"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"host":"%%host%%","port":"6379","password":"%%env_REDIS_PASSWORD%%"}]'

참고: "%%env_<ENV_VAR>%%" 템플릿 변수 로직은 암호를 일반 텍스트로 저장하지 않기 위해 사용하므로, REDIS_PASSWORD 환경 변수가 에이전트 컨테이너에 설정되어야 합니다. 자세한 내용은 자동 탐지 템플릿 변수 설명서를 참조하세요. 또는 에이전트는 secrets 패키지를 활용하여 모든 시크릿 관리 백엔드(예: HashiCorp Vault 또는 AWS Secrets Manager)를 사용할 수 있습니다.

로그 수집

Agent 버전 6.0 이상에서 사용 가능

기본적으로 로그 수집은 Datadog 에이전트에서 비활성화되어 있습니다. 활성화하려면 도커(Docker) 로그 수집을 참고하세요.

그런 다음 도커(Docker) 레이블로 로그 통합을 설정하세요.

LABEL "com.datadoghq.ad.logs"='[{"source":"redis","service":"<YOUR_APP_NAME>"}]'

트레이스 수집

컨테이너화된 앱용 APM은 Agent v6+에서 지원되지만 트레이스 수집을 시작하려면 추가 구성이 필요합니다.

Agent 컨테이너의 필수 환경 변수:

사용 가능한 환경 변수 및 설정의 전체 목록은 도커(Docker) 애플리케이션 추적을 참조하세요.

그런 다음 Redis에 요청하는 애플리케이션 컨테이너를 계측하고 DD_AGENT_HOST를 에이전트 컨테이너의 이름으로 설정합니다.

쿠버네티스(Kubernetes)

쿠버네티스에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

메트릭을 수집하려면 다음 파라미터와 값을 자동탐지 템플릿에 설정합니다. Redis 포드의 쿠버네티스 어노테이션(아래 표시) 또는 로컬 파일, ConfigMap, 키-값 저장소, Datadog Operator 매니페스트 또는 헬름(Helm) 차트를 통해 이를 수행할 수 있습니다.

주석 v1(Datadog 에이전트 v7.36 이하용)

apiVersion: v1
kind: Pod
metadata:
  name: redis
  annotations:
    ad.datadoghq.com/redis.check_names: '["redisdb"]'
    ad.datadoghq.com/redis.init_configs: '[{}]'
    ad.datadoghq.com/redis.instances: |
      [
        {
          "host": "%%host%%",
          "port":"6379",
          "password":"%%env_REDIS_PASSWORD%%"
        }
      ]      
  labels:
    name: redis
spec:
  containers:
    - name: redis
      image: redis:latest
      ports:
        - containerPort: 6379

주석 v2(Datadog 에이전트 v7.36 이상용)

apiVersion: v1
kind: Pod
metadata:
  name: redis
  annotations:
    ad.datadoghq.com/redis.checks: |
      {
        "redisdb": {
          "init_config": {},
          "instances": [
            {
              "host": "%%host%%",
              "port":"6379",
              "password":"%%env_REDIS_PASSWORD%%"
            }
          ]
        }
      }      
  labels:
    name: redis
spec:
  containers:
    - name: redis
      image: redis:latest
      ports:
        - containerPort: 6379

참고: "%%env_<ENV_VAR>%%" 템플릿 변수 로직은 암호를 일반 텍스트로 저장하지 않기 위해 사용하므로, REDIS_PASSWORD 환경 변수가 에이전트 컨테이너에 설정되어야 합니다. 자동 탐지 템플릿 변수 설명서를 참조하세요. 또는 에이전트는 secrets 패키지를 활용하여 모든 시크릿 관리 백엔드(예: HashiCorp Vault 또는 AWS Secrets Manager)를 사용할 수 있습니다.

로그 수집

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

Datadog 에이전트에서 로그 수집은 기본값으로 비활성화되어 있습니다. 이를 활성화하려면 쿠버네티스(Kubernetes) 로그 수집을 참조하세요.

그런 다음 자동탐지 템플릿에서 다음을 파라미터를 설정합니다. Redis 포드에서 쿠버네티스(Kubernetes) 어노테이션(아래 표시)을 사용하거나 로컬 파일, ConfigMap, 키-값 저장소, Datadog Operator 매니페스트 또는 헬름(Helm) 차트를 사용하여 이 작업을 수행할 수 있습니다.

주석 v1/v2

apiVersion: v1
kind: Pod
metadata:
  name: redis
  annotations:
    ad.datadoghq.com/redis.logs: '[{"source":"redis","service":"<YOUR_APP_NAME>"}]'
  labels:
    name: redis
spec:
  containers:
    - name: redis
      image: redis:latest
      ports:
        - containerPort: 6379

트레이스 수집

컨테이너화된 앱용 APM은 Agent v6+를 실행하는 호스트에서 지원되지만 트레이스 수집을 시작하려면 추가 구성이 필요합니다.

Agent 컨테이너의 필수 환경 변수:

사용 가능한 환경 변수 및 구성의 전체 목록은 Kubernetes 애플리케이션 추적 및 Kubernetes 데몬 설정을 참조하세요.

그런 다음 Redis에 요청하는 애플리케이션 컨테이너를 계측합니다.

ECS

ECS에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에 자동탐지 통합 템플릿을 Docker 레이블로 설정하세요.

{
  "containerDefinitions": [{
    "name": "redis",
    "image": "redis:latest",
    "dockerLabels": {
      "com.datadoghq.ad.check_names": "[\"redisdb\"]",
      "com.datadoghq.ad.init_configs": "[{}]",
      "com.datadoghq.ad.instances": "[{\"host\":\"%%host%%\",\"port\":\"6379\",\"password\":\"%%env_REDIS_PASSWORD%%\"}]"
    }
  }]
}

참고: "%%env_<ENV_VAR>%%" 템플릿 변수 로직은 암호를 일반 텍스트로 저장하지 않기 위해 사용하므로, REDIS_PASSWORD 환경 변수가 에이전트 컨테이너에 설정되어야 합니다. 자동 탐지 템플릿 변수 설명서를 참조하세요. 또는 에이전트는 secrets 패키지를 활용하여 모든 시크릿 관리 백엔드(예: HashiCorp Vault 또는 AWS Secrets Manager)를 사용할 수 있습니다.

로그 수집

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

기본적으로 로그 수집은 Datadog 에이전트에서 비활성화되어 있습니다. 활성화하려면 ECS 로그 수집을 참조하세요.

그런 다음 도커(Docker) 레이블로 로그 통합을 설정하세요.

{
  "containerDefinitions": [{
    "name": "redis",
    "image": "redis:latest",
    "dockerLabels": {
      "com.datadoghq.ad.logs": "[{\"source\":\"redis\",\"service\":\"<YOUR_APP_NAME>\"}]"
    }
  }]
}

트레이스 수집

컨테이너화된 앱용 APM은 Agent v6+에서 지원되지만 트레이스 수집을 시작하려면 추가 구성이 필요합니다.

Agent 컨테이너의 필수 환경 변수:

사용 가능한 환경 변수 및 설정의 전체 목록은 도커(Docker) 애플리케이션 추적을 참조하세요.

그런 다음 Redis에 요청하는 애플리케이션 컨테이너를 계측하고 DD_AGENT_HOST를 EC2 비공개 IP 주소로 설정합니다.