Grafana 플러그인용 새 Redis 데이터 소스를 사용하는 방법

이달 초 Redis는 널리 사용되는 오픈 소스 애플리케이션 모니터링 도구를 Redis에 연결하는 새로운 Redis Data Source for Grafana 플러그인을 출시했습니다. 모든 작동 방식에 대한 아이디어를 제공하기 위해 자체 참조 예제를 살펴보겠습니다. 플러그인을 사용하여 시간이 지남에 따라 다운로드된 횟수를 확인합니다. (Grafana 플러그인 저장소 자체는 이러한 통계를 즉시 제공하지 않습니다.)

자세히 알아보시겠습니까? 읽기 Grafana용 Redis 데이터 소스 플러그인 소개

Grafana용 Redis 데이터 소스는 무엇입니까?

Grafana에 익숙하지 않다면 애플리케이션, 인프라 및 소프트웨어 구성 요소를 모니터링하는 대시보드를 구축하는 데 사용되는 매우 인기 있는 도구입니다. Grafana용 Redis 데이터 소스는 사용자가 Redis 데이터베이스에 연결하고 Grafana에서 대시보드를 구축하여 Redis 데이터를 쉽게 모니터링할 수 있도록 하는 플러그인입니다. 즉시 사용 가능한 사전 정의 대시보드를 제공하지만 특정 요구 사항에 맞게 조정된 사용자 지정 대시보드를 구축할 수도 있습니다.

Redis Data Source for Grafana 플러그인은 grafana-cli, Docker를 사용하여 설치하거나 Grafana 클라우드에서 사용할 수 있습니다. 또는 GitHub의 지침에 따라 플러그인을 처음부터 빌드할 수 있습니다.

grafana-cli plugins install redis-datasource

전제조건

이 데모는 다음을 사용합니다:

Node 패키지 관리자(npm)가 있는 Node.js 10.x
도커
도커 작성
RedisTimeSeries가 포함된 Redis 5.0.x 이상(이 데모에서는 Redis Docker 컨테이너 사용)
Redis 데이터 소스가 포함된 Grafana 7.0 이상(이 데모에서는 Grafana Docker 컨테이너 사용)

Grafana 플러그인 정보를 검색하는 방법

Grafana 저장소에 등록된 플러그인에 대한 정보는 API를 사용하여 JSON 형식으로 검색할 수 있습니다.

GET https://grafana.com/api/plugins/redis-datasource/versions/latest{  "id":2613,  "pluginId":639,  "pluginSlug":"redis-datasource",  "버전":"1.1.2",  "url":"https://github.com/RedisTimeSeries/grafana-redis-datasource/",...  "downloads":1153,  "verified":false,  "status":"활성 ",  "패키지":{    "any":{     "md5":"ea0a2c9cb11c9fad66703ba4291e61cb",      "packageName":"any",     "download/versions/1" ,

이 예에서는 Redis Data Source for Grafana 플러그인이 하루에 다운로드된 횟수를 확인하고 이에 대해 Redis 블로그에 트윗하거나 게시한 후 급증을 찾고 싶었습니다. 저는 RedisTimeSeries(Redis에 시계열 데이터 구조를 추가하는 Redis 모듈)를 사용하여 매시간 다운로드 수를 추적하기로 결정했습니다.

데이터를 채우기 위해 TS.ADD를 사용했습니다. 자동 타임스탬프와 `plugin 레이블이 있는 명령 ` 및 `버전 `. X는 다운로드 횟수 및 API에서 가져온 최신 버전 '1.1.2'입니다. 레이블은 나중에 시계열을 쿼리하는 데 사용됩니다.

127.0.0.1:6379> ts.add redis-datasource * X LABELS 플러그인 redis-datasource 버전 1.1.2

ioredis 및 Axios 라이브러리를 사용하여 API를 호출하고 플러그인 정보를 사용하여 시계열 샘플을 추가하는 간단한 스크립트를 작성했습니다.

/** * Node.js를 위한 강력하고 성능 중심의 완전한 기능을 갖춘 Redis 클라이언트입니다. * * @see https://github.com/luin/ioredis */const Redis =require("ioredis");/** * 브라우저 및 node.js를 위한 Promise 기반 HTTP 클라이언트 * * @see https:// github.com/axios/axios */const axios =require("axios");/** * TLS 암호화를 사용할 때 연결 옵션을 redis:// URL 또는 rediss:// URL로 지정할 수도 있습니다. */const redis =new Redis("redis://localhost:6379");/** * Main * * @async * @param {string} 플러그인 플러그인 이름 */async function main(plugin) {  /**   * 플러그인 데이터 가져오기   * * @참조 https://grafana.com/api/plugins/redis-datasource/versions/latest   */  const 응답 =await axios.get(    `https://grafana.com/api/plugins/${plugin}/ 버전/최신`  ); /**   * 응답   */  const data =response.data; if (!data) {    console.log("데이터는 어디에 있습니까?"); 반품; }  /**   * 플러그인 및 버전 레이블이 있는 시계열 샘플 추가   */  await redis.send_command(    "TS.ADD",    data.pluginSlug,    "*",    data.downloads,    "LABELS",     "plugin", pluginSlug,    "버전",    data.version  ); /**   * Redis 연결 닫기   */  await redis.quit();}/** * Start */main("redis-datasource");

내 스크립트 환경

package.json 파일을 사용하여 종속성을 설치하고 `npm을 사용하여 명령을 실행했습니다. ` 여기에 표시된 대로:

{  "author":"Mikhail Volkov",  "dependencies":{    "axios":"^0.19.2",    "ioredis":"^4.17.3"  },  "description":"Grafana에 대한 통계 가져오기 플러그인",  "devDependencies":{    "@types/node":"^14.0.27"  },  "license":"ISC",  "name":"grafana-plugin-stats",  "scripts":{    "redis -cli":"docker exec -it redistimeseries redis-cli",    "start":"docker-compose up",    "start:app":"node grafana-plugin-stats.ts"  },  "version":"1.0 .0"}

Docker 컨테이너를 조정하기 위해 docker-compose:

를 사용했습니다.

Redis 서비스는 RedisTimeSeries 모듈이 활성화된 redis/redistimeseries 이미지를 기반으로 합니다.
Grafana 서비스는 저장소에서 설치된 Redis Data Source 플러그인과 함께 최신 Grafana 릴리스를 사용합니다.

버전:"3.4" 서비스: redis: container_name:redistimeseries image:redis/redistimeseries:latest ports: - 6379:6379 portanas0:grafana: container_name: grafana - GF_AUTH_ANONYMOUS_ORG_ROLE=관리자 - GF_AUTH_ANONYMOUS_ENABLED=true - GF_AUTH_BASIC_ENABLED=false - GF_ENABLE_GZIP=소스=true - PLUG_INS

매시간 스크립트를 실행하고 다운로드 데이터를 수집하기 위해 클라우드의 Linux 서버에서 crontab을 사용했습니다.

root@grafana:~# crontab -l5 * * * * 노드 /root/grafana-plugin-stats/stats.ts

Grafana 플러그인용 Redis 데이터 소스 테스트

스크립트를 실행하고 데이터를 수집하려면 운영 체제 지침에 따라 Node.js, Docker 및 Docker Compose를 설치해야 합니다.

> docker-compose up -dGrafana 시작       ... doneredistimeseries 시작 ... done...redistimeseries | 1:M 08 Aug 2020 21:13:20.405 *  RedisTimeSeries에서 찾은 Redis 버전:6.0.1 - oss...grafana    | redis-datasource @ 1.1.2grafana 설치 중    | 출처:https://grafana.com/api/plugins/redis-datasource/versions/1.1.2/download...grafana    | t=2020-08-08T21:13:23+0000 lvl=info msg="플러그인 등록" logger=플러그인 이름=Redisgrafana    | t=2020-08-08T21:13:23+0000 lvl=info msg="HTTP 서버 수신" logger=http.server address=[::]:3000 protocol=http subUrl=socket=

스크립트를 실행한 후 TS.MRANGE를 사용하여 RedisTimeSeries 데이터를 확인할 수 있습니다. 명령. 필터를 순방향 또는 역방향으로 사용하여 여러 시계열에서 범위를 쿼리할 수 있습니다.

127.0.0.1:6379> ts.mrange - + withlabels 필터 플러그인=redis-datasource1) 1) "diff:redis-datasource"   2) 1) 1) "값"         2) "차이"      2) 1) " 유형"         2) "데이터 원본"      3) 1) "플러그인"         2) "redis-datasource"      4) 1) "버전"         2) 2) 2) 2 ) 7   1) 1 6  1) (정수) 1597129202847           2) 1        3) 1) (정수) 1597132802738           2) 10

TS.MRANGE 명령 필터 `플러그인 사용 ` `redis-datasource에 대한 샘플만 검색합니다. ` 플러그인. WITHLABELS 옵션 사용 레이블을 반환합니다.

Grafana에서 RedisTimeSeries 데이터를 표시하는 방법

`https://localhost:3000을 사용하여 웹 브라우저에서 Grafana를 엽니다. ` 구성 -> 데이터 소스를 선택하여 데이터 소스를 생성합니다. Grafana용 Redis 데이터 소스는 TLS(전송 계층 보안)를 지원하며 직접 연결을 사용하여 어디에서나 오픈 소스 Redis OSS, Redis Enterprise 및 Redis Enterprise Cloud 데이터베이스에 연결할 수 있습니다.

다음 단계는 그래프 패널이 있는 대시보드를 만들어 데이터를 시각화하는 것입니다. 쿼리 편집기에서 "Redis Datasource" 및 "RedisTimeSeries 명령"을 선택합니다. TS.MRANGE 명령 사용 플러그인 이름 필터로.

마지막으로 플러그인 이름을 범례 레이블로 지정하고 버전을 값 레이블로 설정하면 Grafana용 Redis 데이터 소스의 이후 버전에 대한 시리즈를 더 쉽게 표시할 수 있습니다.

결과 확인

TS.INFO 명령 사용 시계열에 대한 정보 및 통계를 봅니다. 지금까지 250시간 동안 다운로드 데이터를 수집했으며 시계열 및 기타 정보를 저장하기 위해 할당된 메모리(바이트)를 확인할 수 있습니다.

127.0.0.1:6379> ts.info diff:redis-datasource 1) totalSamples 2) (정수) 250 3) memoryUsage 4) (정수) 4313 5) firstTimestamp 6) (정수) 159712568025 lastTimest 정수) 1598022003033 9) retentionTime10) (정수) 011) chunkCount12) (정수) 113) maxSamplesPerChunk14) (정수) 25615) labels16) 1) 1) "값"        2) "diff2" datasource"    3) 1) "플러그인"       2) "redis-datasource"    4) 1) "버전"       2) "1.1.2"17) sourceKey18) (nil)19) 규칙20) (빈 목록 또는 집합)

발행 당시 Redis Data Source for Grafana 플러그인은 3500회 이상 다운로드되었습니다! 우리는 커뮤니티로부터 귀중한 피드백을 받았으며 데이터 소스에 대한 새로운 기능을 계속 개발하고 있습니다.

자세한 내용은 프로젝트의 GitHub 리포지토리를 살펴보고 문제에 대해 질문이 있으면 알려주세요.

결론

이 게시물과 Grafana용 Redis 데이터 소스를 사용하여 시간 경과에 따른 플러그인 다운로드를 추적하는 예제가 이 새로운 도구의 강력함과 사용 편의성을 보여주고 애플리케이션 데이터(트랜잭션, 스트림 , 큐 등) RedisTimeSeries를 사용합니다. Redis Data Source for Grafana 플러그인을 사용하는 방법과 이유에 대한 추가 게시물을 기대해 주세요.