Loki 커넥터

Loki 커넥터 (Loki connector)

Loki 커넥터는 Grafana Loki에 저장된 로그 데이터를 질의할 수 있게 해 줘요. 이 문서는 Loki 커넥터로 카탈로그를 구성해 Loki에 대해 SQL 쿼리를 실행하는 방법을 설명해요.

출처: 문서

본문

요구사항 (Requirements)

Loki에 연결하려면 다음이 필요해요:

• Loki 3.2.0 이상.
• Trino 코디네이터와 워커에서 Loki로 네트워크 접근. 기본 포트는 3100이에요.

설정 (Configuration)

이 커넥터는 Loki의 로그 데이터를 질의할 수 있어요. connector.name을 loki로 설정해 Loki 커넥터를 지정하는 카탈로그 속성 파일을 만드세요.

예를 들어 example 카탈로그로 접근하려면 etc/catalog/example.properties 파일을 만드세요:

connector.name=loki
loki.uri=http://loki.example.com:3100

쿼리 예시

query_range 테이블 함수로 로그 쿼리와 시간 범위를 지정해 조회할 수 있어요:

SELECT timestamp, value
FROM
  TABLE(
    example.system.query_range(
      '{origin="CA"}',
      TIMESTAMP '2025-01-01 00:00:00',
      TIMESTAMP '2025-01-02 00:00:00'
    )
  )
;

메트릭 쿼리 결과도 조회할 수 있어요:

SELECT value AS count
FROM
  TABLE(
    example.system.query_range(
      'count_over_time({test="metrics_query"}[5m])',
      TIMESTAMP '2025-01-01 00:00:00',
      TIMESTAMP '2025-01-02 00:00:00'
    )
  )
ORDER BY timestamp DESC
LIMIT 100;

반환된 labels 맵에서 특정 라벨을 추출할 수 있어요:

SELECT
  timestamp,
  value,
  labels['province'] AS province
FROM
  TABLE(
    example.system.query_range(
      '{origin="CA"}',
      TIMESTAMP '2025-01-01 00:00:00',
      TIMESTAMP '2025-01-02 00:00:00'
    )
  )
;

더 알아보기 (Learn more)

다른 로그·관측 데이터 커넥터가 궁금하다면 Elasticsearch 커넥터 문서를 이어서 읽어 보세요.