서비스 관측성 템플릿 변수

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분

    • 대시보드와 차트를 편집 서비스 관측성 할 때 쿼리에 사용할 수 있는 템플릿 변수를 이해합니다.

    쿼리에 다음 템플릿 변수를 사용할 수 있습니다. 변수를 사용하면 대시보드에 대해 현재 선택된 기간뿐만 아니라 여러 서비스, 호스트 및 데이터베이스 인스턴스에 쿼리를 사용할 수 있습니다.
    주:
    Amazon CloudWatch 는 약간 다른 템플릿 변수를 사용합니다. 자세한 내용은 AWS 및 Azure에 대한 고급 쿼리 지원 문서를 참조하십시오.
    표 1. 템플릿 변수
    변수 설명
    {$ENTITIES_호스트} 선택한 호스트에 대한 메트릭을 반환합니다.
    {$ENTITIES_MYSQL} 선택한 MySQL 인스턴스에 대한 메트릭을 반환합니다.
    {$ENTITIES_POSTGRESQL} 선택한 PostgreSQL 인스턴스에 대한 메트릭을 반환합니다.
    {$ENTITIES_SERVICE} 선택한 서비스에 대한 메트릭을 반환합니다.
    {$ENTITIES} 선택한 엔터티에 대한 메트릭을 반환합니다. 서비스, 호스트 또는 데이터베이스 중 하나입니다.
    {$START_시간} 선택한 시작 시간을 사용하여 메트릭 시계열을 반환합니다.
    {$END_시간} 선택한 종료 시간을 사용하여 메트릭 시계열을 반환합니다.

    예제 쿼리

    New Relic을 사용 중이고 주요 서비스를 값 checkout-service에 매핑하는 데이터 매핑을 생성한다고 가정해 보겠습니다.

    쿼리 작성기를 사용하여 작성된 간단한 쿼리는 다음과 같습니다.
    rate(count(apm.service.transaction.duration), 1 minute
    체크아웃 서비스 서비스에 대한 트랜잭션 비율을 반환합니다.
    대신 다음과 같은 전체 벤더 쿼리를 사용할 수 있습니다.
    SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'Web throughput' FROM Metric WHERE (entity.guid = 'NDc2NDMyNXxBUE18QVBQTElDQVRJT058MTA3NjIyODQwMw') AND (transactionType = 'Web') LIMIT MAX SINCE 30 minutes ago TIMESERIES UNTIL now
    지난 30분 동안 하드 코딩된 NDc2NDMyNXxBUE18QVBQTElDQVRJT058MTA3NjIyODQwMw 엔터티에 대한 기간을 반환합니다.
    언제든지 선택한 서비스에 대한 시계열을 반환하는 쿼리를 만들려면 엔터티와 시간을 템플릿 변수로 바꾸면 됩니다.
    SELECT average(convert(apm.service.transaction.duration, unit, 'ms')) as metricValue, average(convert(apm.service.transaction.duration, unit, 'ms')) - 100 as loop FROM Metric WHERE entity.guid IN (${ENTITIES}) FACET entity.guid, entity.name SINCE ${START} UNTIL ${END} TIMESERIES LIMIT 25