개요

InfluxDB등의 데이터로부터 생성한 그래프를 grafana로 가시화할 때, 이벤트 등을 오버레이 해 표시하는 「annotation」이라고 불리는 기능이 있습니다

grafana의 「annotation」은 InfluxDB 이외의 Elasticsearch등의 데이터 소스에도 대응하고 있습니다만, 본 엔트리에서는 InfluxDB에 있어서의 「annotation」의 사용법에 대해 정리합니다

또한 grafana를 통해 InfluxDB의 데이터를 볼 수 있다는 것을 전제로 본 항목을 작성합니다.

실현할 수 있는 일

할 수 있는 일

기록 된 이벤트 발생 타이밍을 그래프에 오버레이

추가 텍스트 추가

오버레이에 사용하는 선이나 마크의 색을 나누기

할 수없는 일 (2015/03)

grafana의 UI에서 그래프를 보면서 이벤트 정보를 기록합니다.

특정 그래프에만 이벤트 오버레이

이벤트 정보 등록

'기록된 이벤트'를 어떻게 기록하는지에 대해 설명합니다.

데이터 형식

grafana로 설정한 datasource의 「events」series에, 아래의 컬럼을 설정해 저장하면, 간단하게 grafana로부터 이벤트를 취득하도록 설정할 수 있습니다

title

tags

text

InfluxDB에서 일반적으로 수행하는 것처럼 이벤트에 시간을 명시 적으로 지정하는 경우 (현재 시간이 아닌 과거 또는 미래의 이벤트를 만드는 경우) time을 추가로 지정하십시오.

기록 방법

이벤트 기록은

로그를 통해 기록 (fluentd-plugin-influxdb 등을 활용)

curl 명령으로 직접 이벤트 기록

제3자 도구 이용

htps : // 기주 b. 코 m / 응 r ぇ y / 안오 타테 익 fぅ xdb

등 다양한 방법을 생각할 수
적절하게 기록하십시오.

grafana 설정

grafana는 annotation을 활성화/비활성화하고 이벤트 정보와 annotation 열을 연결합니다.

주석 활성화/비활성화

화면 오른쪽 상단의 Configure dashboard > Features (tab)를 선택하고 Annotations를 선택합니다.





화면 왼쪽 상단에 기어 마크가 표시되면 잘 작동합니다.

이벤트 정보와 annotation 열의 연결

상기 「이벤트 정보의 등록」에 설정 예를 나타냈습니다만, grafana에 설정 끝난 임의의 datasource(많은 경우는 database), 임의의 series, 속성을 이벤트 정보로서 이용할 수 있습니다

Annotations > Add (tab)에서 Annotation을 만듭니다.

Name

Annotation (이벤트 열)의 식별자이므로 적절하게 부여하십시오

InfluxDB Query

이벤트 정보를 검색 할 수있는 쿼리를 지정하십시오

Column mappings

이벤트를 제목, 태그 및 텍스트라는 열 이외에 저장할 때 어떤 열을 어떻게 연결할지 지정하십시오.

여기서는 events라는 이름을 부여합니다.

아래와 같은 오버레이가 표시됩니다.



선이나 마크를 커스터마이즈 할 수 있기 때문에, 이벤트 종별마다 색을 바꾸거나 이벤트 개시/종료로 색을 바꾸는 등의 이용 방법을 생각할 수 있을 것 같네요

마지막으로

피드백을 주시면 수시로 대응하겠습니다.
아래 관점에서 코멘트 주시면 좋겠습니다.

잘못된 내용

추가 정보 (이것을 알고 있어!라는 이야기)

기사로 하고 싶은 것

고마워요