Redis 모니터링 통합

Redis 통합은 Redis 서버에서 New Relic 제품으로 중요한 성능 데이터를 보고합니다. 사전 구축된 대시보드에서 이 메트릭 데이터 및 인벤토리 데이터 를 보고, 경고 정책을 생성하고, 사용자 지정 쿼리 및 차트를 생성할 수 있습니다. 또한 애플리케이션에 중요한 키를 지정하고 키 길이에 대한 정보를 얻을 수 있습니다.

통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.

호환성 및 요구 사항

우리의 통합은 3.0에서 7.0까지의 Redis 버전과 호환됩니다.

통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.

New Relic 계정. 하나가 없습니까? 무료 가입! 신용 카드가 필요하지 않습니다.
Redis가 Kubernetes 또는 Amazon ECS에서 실행되고 있지 않으면 Redis를 실행하는 Linux OS 호스트에 인프라 에이전트를 설치 해야 합니다. 그렇지 않으면:
- Kubernetes에서 실행 중인 경우 다음 요구 사항 을 참조하십시오.
- ECS에서 실행하는 경우 다음 요구 사항 을 참조하십시오.

통합은 Redis 명령을 실행하여 데이터를 가져옵니다.

INFO 명령 : INFO 명령의 데이터가 측정항목 데이터와 일부 인벤토리 데이터를 채웁니다.
CONFIG GET 명령 : 대부분의 인벤토리 데이터는 이 명령에서 가져옵니다.
- CONFIG 명령(예: AWS ElastiCache)을 실행할 권한이 없는 관리형 Redis 설치에서는 config_inventory: false 구성 옵션을 사용하여 이 명령의 실행을 비활성화할 수 있습니다.
키 길이 획득: 키 유형에 따라 다음 명령이 사용됩니다.
- LLEN 에 대한 list
- SCARD 에 대한 set
- ZCOUNT 에 대한 zset
- { hash 유형의 경우 HLEN .

키 길이 데이터 수집의 경우 에이전트는 파이프라이닝 을 사용하여 Redis 성능에 미치는 영향을 최소화합니다. 그러나 많은 키의 길이를 수집하는 경우 Redis 성능에 영향을 줄 수 있습니다. 이러한 이유로 에이전트에는 기본 키 제한이 포함됩니다(그러나 이 제한은 덮어쓸 수 있음).

중요

위에서 언급한 Redis 명령의 이름을 편집한 경우 통합에서 Redis 데이터를 검색할 수 없습니다.

빠른 시작

Redis 서버를 신속하게 계측하고 설치 안내를 통해 원격 측정 데이터를 보내십시오. 가이드 설치는 New Relic CLI 및 인프라 에이전트를 다운로드하고 설치하는 사용자 환경에 대한 사용자 정의 CLI 명령을 생성합니다.

시작할 준비가 되셨습니까? 이 버튼 중 하나를 클릭하여 사용해 보십시오.

안내 설치

EU 가이드 설치

설치 및 활성화

Redis 통합을 설치하려면 환경에 대한 지침을 따르세요.

추가 참고 사항:

Advanced:
통합은 Tarball 형식 으로도 제공되므로 클라이언트 매니저 외부에서 설치가 가능합니다.
On-host integrations do not automatically update.
최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.

' '

인프라 에이전트를 설치하고 INTEGRATION_FILE_NAME 변수를 nri-redis 로 바꿉니다.
디렉토리를 통합 구성 폴더로 변경하십시오.
bash
```
$cd /etc/newrelic-infra/integrations.d
```

샘플 구성 파일을 복사합니다.

bash

$sudo cp redis-config.yml.sample redis-config.yml

Redis 서버 연결 방법에 따라 redis-config.yml 파일을 편집합니다.
Unix 소켓을 사용하여 연결하는 경우 구성 파일 에 unix_socket_path 을 지정합니다. Unix 소켓을 사용하는 Redis 인스턴스가 두 개 이상인 경우 구성 파일 에서 use_unix_socket 을 true 로 설정해야 합니다.
Redis 통합을 실행하는 사용자에게 해당 Unix 소켓에 액세스할 수 있는 올바른 권한이 있는지 확인하십시오. Unix 소켓의 권한은 Redis 구성(값 unixsocketperm )에서 설정됩니다.
필요한 경우 구성 에 설명된 대로 Redis 설정을 기반으로 다른 구성 파일 설정을 지정 합니다.
자동 Redis 오류 로그 구문 분석 및 전달을 활성화하려면 redis-log.yml.example 파일을 redis-log.yml 에 복사(또는 이름 변경)하십시오. 에이전트를 다시 시작할 필요가 없습니다.
Example:
bash
```
$sudo cp /etc/newrelic-infra/logging.d/redis-log.yml.example /etc/newrelic-infra/logging.d/redis-log.yml
```

다음에서 nri-redis .MSI 설치 프로그램 이미지를 다운로드합니다.
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-redis/nri-redis-amd64.msi
Windows 명령 프롬프트에서 설치하려면 다음을 실행하십시오.
bash
```
$msiexec.exe /qn /i PATH\TO\nri-redis-amd64.msi
```
또는 탐색기에서 파일을 두 번 클릭합니다.
Integrations 디렉터리 C:\Program Files\New Relic\newrelic-infra\integrations.d\ 에서 다음을 실행하여 샘플 구성 파일의 복사본을 만듭니다.
bash
```
$copy redis-win-config.yml.sample redis-win-config.yml
```
구성 설정 에 설명된 대로 redis-win-config.yml 파일을 편집합니다.

이 문서가 설치하는데 도움이 되셨나요?

Redis 서버를 위한 New Relic 사용자 생성

Redis 6 이상을 사용 중이고 ACL(액세스 제어 목록)을 사용하여 인스턴스에 대한 액세스를 제어하는 경우 통합을 위해 newrelic 사용자를 생성할 수 있습니다. 다음 명령을 사용하여 필요한 권한을 생성하고 사용자에게 부여합니다.

bash

$ACL SETUSER newrelic on >'YOUR_SELECTED_PASSWORD' ~* +INFO +CONFIG|GET +SELECT +TYPE +LLEN +SCARD +ZCOUNT +HLEN

통합 구성

설치 방법에 따라 통합을 구성하는 몇 가지 방법이 있습니다.

Kubernetes를 통해 활성화된 경우: Kubernetes에서 실행 중인 서비스 모니터링을 참조하십시오.
Amazon ECS를 통해 활성화된 경우: ECS에서 실행 중인 서비스 모니터링을 참조하십시오.
호스트에 설치된 경우: 통합의 YAML 구성 파일 redis-config.yml 에서 구성을 편집합니다.

YAML 구성을 사용하여 필요한 로그인 자격 증명을 배치하고 설정 및 기본 설정에 따라 데이터 수집 방법을 구성합니다.

구성 파일에는 interval , timeout , inventory_source 와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대해 자세히 알아보려면 YAML 구성 형식 을 참조하세요.

중요

레거시 구성/정의 파일을 계속 사용하고 있다면 이전의 표준 구성 형식 을 사용하세요.

Redis와 관련된 특정 설정은 구성 파일의 env 섹션을 사용하여 정의됩니다. 이러한 설정은 Redis 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다.

Redis 인스턴스 설정

Redis 통합은 지표(M) 및 인벤토리(I) 정보를 모두 수집합니다. 표에서 각 컬렉션에 사용할 수 있는 설정에 대한 Applies To 열을 사용합니다.

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

환경	설명	기본값	적용 대상
`HOSTNAME`	Redis 서버 호스트 이름.	`localhost`	미
`PORT`	Redis 서버가 수신 대기하는 포트입니다.	`6379`	미
`USERNAME`	Redis 서버에 연결할 때 사용할 사용자 이름입니다. ACL이 활성화된 경우 Redis 6+에서만 사용하십시오.	해당 없음	미
`PASSWORD`	Redis 서버에 연결할 때 사용할 비밀번호입니다. `REQUIREPASS` 또는 ACL이 활성화된 경우 Redis 서버에서만 사용합니다.	해당 없음	미
`UNIX_SOCKET_PATH`	Redis 서버가 수신하는 Unix 소켓 파일의 경로입니다. 호스트 이름/포트 대신 이것을 사용하십시오.	해당 없음	미
`USE_UNIX_SOCKET`	Unix 소켓을 사용할 때 모니터링되는 엔터티를 고유하게 식별하려면 `true` 으로 설정합니다.	`false`	미
`USE_TLS`	Redis 서버와 통신할 때 TLS를 사용합니다.	`false`	미
`TLS_INSECURE_SKIP_VERIFY`	TLS를 통해 연결할 때 서버 이름 확인을 비활성화합니다.	`false`	미
`KEYS`	길이를 검색하기 위한 키 목록입니다.	해당 없음	중
`KEYS_LIMIT`	길이를 검색할 최대 키 수입니다.	`30`	중
`CONFIG_INVENTORY`	Redis CONFIG 명령이 허용되지 않는 환경(예: AWS 또는 ElastiCache)에서는 'false'로 설정합니다.	`true`	나
`RENAMED_COMMANDS`	기본 Redis 명령을 이름이 변경된 양식에 매핑합니다.	해당 없음	미
`REMOTE_MONITORING`	다중 테넌시 모니터링을 활성화합니다.	`true`	미
`METRICS`	측정항목 전용 수집을 활성화하려면 `true` 으로 설정합니다.	`false`
`INVENTORY`	인벤토리 전용 컬렉션을 활성화하려면 `true` 으로 설정합니다.	`false`

이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.

값을 구성 파일에 직접 추가하십시오. 이것은 가장 일반적인 방법입니다.
{{}} 표기법을 사용하여 환경 변수의 값을 바꿉니다. 이를 위해서는 인프라 에이전트 1.14.0 이상이 필요합니다. 이에 대한 자세한 내용은 인프라 에이전트 통과 환경 변수 에 대한 자세한 내용을 참조하십시오.
비밀 관리를 사용하여 비밀번호와 같은 민감한 정보를 보호하여 구성 파일에 일반 텍스트로 노출되지 않도록 합니다. 자세한 내용은 비밀 관리 를 참조하십시오.

라벨 및 사용자 정의 속성

레이블을 사용하여 측정항목을 꾸밀 수도 있습니다. 레이블을 사용하면 메트릭에 키/값 쌍 속성을 추가하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.

기본 샘플 구성 파일에 레이블의 예가 포함되어 있지만 선택 사항입니다. 새 항목을 제거, 수정 또는 추가할 수 있습니다.

labels:
  env: production
  role: load_balancer

구성 예

다음은 localhost에서 메트릭 및 인벤토리를 수집하는 데 사용되는 기본 구성입니다.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

이 구성은 기본 인증을 사용하여 Redis에 연결합니다. my_password 을 REQUIREPASS 비밀번호로 바꿉니다.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

Redis 6+에서는 ACL(액세스 제어 목록) 을 사용하여 인스턴스를 보호할 수 있습니다. ACL의 경우 USERNAME 및 PASSWORD 값을 자격 증명으로 바꿉니다.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      USERNAME: my_user
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      USERNAME: my_user
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

TLS를 사용하여 Redis에 연결하는 데 사용합니다. TLS_INSECURE_SKIP_VERIFY : true 을 추가하여 서버 이름 확인을 비활성화할 수 있습니다.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      USE_TLS: true
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

소켓 파일을 사용하여 Redis에 연결하는 데 사용합니다. 이것은 TCP 호스트 이름/포트 연결의 대안입니다.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      UNIX_SOCKET_PATH: /var/run/redis/redis.sock
      USE_UNIX_SOCKET: true
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

rename-command 을 사용하여 인스턴스를 보호한 경우 이를 사용하여 측정항목/인벤토리를 수집합니다.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      RENAMED_COMMANDS: '{"CONFIG":"b840fc9f15f59e41cb7be6c52","LLEN":"c940fc2d15f59e41cb7be6c21"}'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      RENAMED_COMMANDS: '{"CONFIG":"b840fc9f15f59e41cb7be6c52"}'
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

동일한 통합을 사용하여 두 개의 서로 다른 Redis 서버에서 메트릭을 수집해야 하는 경우 이를 사용하십시오.

첫 번째 인스턴스의 예는 Redis 데이터베이스 0에서 KEY_1 amd KEY_2 만 수집하는 것입니다. 두 번째 인스턴스의 예는 {"DB":"KEYS"} 를 사용하여 여러 데이터베이스에서 수집하는 방법을 보여줍니다.

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: redis_host_1
      PORT: 6379
      KEYS: '["KEY_1","KEY_2"]'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: redis_host_2
      PORT: 6379
      KEYS: '{"0":["KEY_1","KEY_2"],"1":["KEY_3"]}'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

데이터 찾기 및 사용

이 서비스의 데이터는 통합 대시보드 에 보고됩니다.

측정항목은 RedisSample 및 RedisKeyspaceSample 이벤트 유형 에 연결됩니다. 문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.

데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.

측정항목 데이터

Redis 통합은 다음 메트릭 데이터 속성을 수집합니다.

Redis 샘플 측정항목

다음 속성은 RedisSample 이벤트 유형에 연결됩니다.

이름	설명
`cluster.connectedSlaves`	연결된 슬레이브의 수입니다.
`db.aofLastRewriteTimeInMilliseconds`	마지막 AOF 다시 쓰기 작업의 지속 시간(밀리초)입니다.
`db.aofLastBgrewriteStatus`	마지막 AOF 백그라운드 재작성 작업의 상태를 나타내는 부울.
`db.aofLastWriteStatus`	마지막 AOF 쓰기 작업의 상태를 나타내는 부울입니다.
`db.evictedKeysPerSecond`	초당 최대 메모리 제한으로 인해 제거된 키 수입니다.
`db.expiredKeysPerSecond`	초당 키 만료 이벤트 수입니다.
`db.keyspaceHitsPerSecond`	초당 기본 사전의 성공적인 키 조회 수입니다.
`db.keyspaceMissesPerSecond`	초당 기본 사전에서 실패한 키 조회 수입니다.
`db.latestForkUsecMilliseconds`	최신 포크 작업의 기간(밀리초)입니다.
`db.rdbBgsaveInProgress`	부울. RDB 저장이 진행 중임을 나타내는 플래그입니다.
`db.rdbChangesSinceLastSave`	마지막 덤프 이후의 변경 수입니다.
`db.rdbLastBgsaveStatus`	마지막 RDB 저장 작업의 상태를 나타내는 부울입니다.
`db.rdbLastBgsaveTimeMilliseconds`	마지막 RDB 저장 작업 기간(밀리초)입니다.
`db.rdbLastSaveTime`	마지막으로 성공한 RDB 저장의 에포크 기반 타임스탬프(초)입니다.
`db.syncFull`	슬레이브가 이 마스터와 완전히 동기화한 횟수입니다.
`db.syncPartialErr`	부분 동기화가 완료되지 못한 횟수입니다.
`db.syncPartialOk`	부분 동기화가 완료된 횟수입니다.
`net.blockedClients`	차단 호출( `BLPOP` , `BRPOP` , `BRPOPLPUSH` )에서 보류 중인 클라이언트 수입니다.
`net.clientBiggestInputBufBytes`	현재 클라이언트 연결 중 가장 큰 입력 버퍼입니다.
`net.clientLongestOutputList`	현재 클라이언트 연결 중 가장 긴 출력 목록입니다.
`net.commandsProcessedPerSecond`	서버에서 초당 처리한 명령 수입니다.
`net.connectedClients`	클라이언트 연결 수(슬레이브 연결 제외).
`net.connectionsReceivedPerSecond`	초당 서버에서 수락한 연결 수입니다.
`net.inputBytesPerSecond`	초당 입력된 총 바이트 수입니다.
`net.outputBytesPerSecond`	초당 출력되는 총 바이트 수입니다.
`net.pubsubChannels`	클라이언트 구독이 있는 게시/구독 채널의 글로벌 수입니다.
`net.pubsubPatterns`	클라이언트 구독이 있는 게시/구독 패턴의 전역 번호입니다.
`net.rejectedConnectionsPerSecond`	maxclients 제한으로 인해 거부된 초당 연결 수입니다.
`software.uptimeMilliseconds`	Redis 서버 시작 이후 경과된 시간(밀리초)입니다.
`system.memFragmentationRatio`	`used_memory_rss` 과 `used_memory` 사이의 비율.
`system.totalSystemMemoryBytes`	Redis가 실행 중인 인스턴스에서 사용 가능한 메모리 양(바이트)입니다.
`system.usedCpuSysMilliseconds`	Redis 서버에서 사용한 시스템 CPU(밀리초)입니다.
`system.usedCpuSysChildrenMilliseconds`	백그라운드 프로세스에서 사용하는 시스템 CPU(밀리초)입니다.
`system.usedCpuUserMilliseconds`	Redis 서버에서 소비한 사용자 CPU(밀리초)입니다.
`system.usedCpuUserChildrenMilliseconds`	백그라운드 프로세스에서 사용하는 사용자 CPU(밀리초)입니다.
`system.usedMemoryBytes`	Redis가 할당자를 사용하여 할당한 총 바이트 수(표준 `libc` , `jemalloc` 또는 `tcmalloc` 와 같은 대체 할당자).
`system.usedMemoryLuaBytes`	Lua 엔진에서 사용하는 바이트 수입니다.
`system.usedMemoryPeakBytes`	Redis에서 소비한 최대 메모리(바이트)입니다.
`system.usedMemoryRssBytes`	운영 체제에서 볼 수 있는 Redis가 할당한 바이트 수(상주 세트 크기라고도 함). 이것은 `top(1)` 및 `ps(1)` 과 같은 도구에서 보고된 숫자입니다.

키스페이스 측정항목

Redis 통합은 다음 키스페이스 메타데이터 및 메트릭을 수집합니다. 다음 속성은 RedisKeyspaceSample 이벤트 유형에 연결됩니다.

이름	설명
`db.avgTtl`	보고되는 데이터베이스에 만료가 설정된 키의 평균 TTL(수명)(밀리초)입니다.
`db.keys`	보고되는 데이터베이스의 키 수입니다.
`db.keyspace`	정수(일반적으로 `0` 와 `15` 사이의 숫자)인 Redis 데이터베이스 인덱스입니다. 형식: `db` 다음에 데이터베이스 색인이 옵니다. 예: `db0` , `db1` , `db2` 등
`db.expires`	보고되는 데이터베이스에서 만료된 키의 수입니다.

인벤토리 데이터

인벤토리 데이터에는 Redis 서버에 비밀번호를 저장하는 requirepass 을 제외하고 Redis CONFIG GET 명령에 의해 보고된 모든 것이 포함됩니다. 인벤토리 데이터에 대한 자세한 내용은 인벤토리 데이터 이해 를 참조하십시오.

기타 시스템 데이터

Redis 통합은 Redis 서비스에 대한 다음과 같은 추가 속성 을 수집합니다.

이름	설명
`software.version`	Redis 서버의 버전입니다. 예: `3.2.3` .
`cluster.role`	모니터링 중인 Redis 노드의 역할에 따라 `master` 또는 `slave,` 입니다.

소스 코드 확인

이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.

호환성 및 요구 사항

중요

빠른 시작

설치 및 활성화

ECS

Kubernetes

Linux

유닉스 소켓과 연결

TCP와 연결

윈도우

이 문서가 설치하는데 도움이 되셨나요?

Redis 서버를 위한 New Relic 사용자 생성

통합 구성

중요

Redis 인스턴스 설정

라벨 및 사용자 정의 속성

구성 예

기본 구성

기본 인증

REDIS 6+ ACL 인증

TLS 연결이 있는 측정항목 전용

소켓을 통한 메트릭 전용 연결

이름이 바뀐 명령 사용

키 필터링을 통한 다중 인스턴스 모니터링

데이터 찾기 및 사용

측정항목 데이터

Redis 샘플 측정항목

키스페이스 측정항목

인벤토리 데이터

기타 시스템 데이터

소스 코드 확인

사용자의 편의를 위해 제공되는 기계 번역입니다.

Redis 모니터링 통합

호환성 및 요구 사항 .css-21sua1{background:none;border:none;width:0;padding:0;}

중요

빠른 시작

설치 및 활성화

Kubernetes

Linux

윈도우

이 문서가 설치하는데 도움이 되셨나요?

Redis 서버를 위한 New Relic 사용자 생성

통합 구성

중요

Redis 인스턴스 설정

라벨 및 사용자 정의 속성

구성 예

기본 구성

기본 인증

REDIS 6+ ACL 인증

TLS 연결이 있는 측정항목 전용

소켓을 통한 메트릭 전용 연결

이름이 바뀐 명령 사용

키 필터링을 통한 다중 인스턴스 모니터링

데이터 찾기 및 사용

측정항목 데이터

Redis 샘플 측정항목

키스페이스 측정항목

인벤토리 데이터

기타 시스템 데이터

소스 코드 확인

호환성 및 요구 사항