서비스 관측성 템플릿 변수

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분
  • 대시보드 및 차트를 편집할 서비스 관측성 때 쿼리에 사용할 수 있는 템플릿 변수를 이해합니다.

    쿼리에 다음 템플릿 변수를 사용할 수 있습니다. 변수를 사용하면 여러 서비스, 호스트 및 데이터베이스 인스턴스뿐 아니라 대시보드에서 현재 선택된 기간 동안 쿼리를 사용할 수 있습니다.
    주:
    Amazon CloudWatch 약간 다른 템플릿 변수를 사용합니다. 자세한 내용은 AWS 및 Azure에 대한 고급 쿼리 지원 문서를 참조하십시오.

    아래 나열된 변수 외에도 차트의 데이터 매핑에 사용되는 태그 키를 템플릿 변수로 사용할 수도 있습니다.

    표 1. 템플릿 변수
    변수 설명
    {$ENTITIES_호스트} 선택한 호스트에 대한 메트릭을 반환합니다.
    {$ENTITIES_MYSQL} 선택한 MySQL 인스턴스에 대한 메트릭을 반환합니다.
    {$ENTITIES_POSTGRESQL} 선택한 PostgreSQL 인스턴스에 대한 메트릭을 반환합니다.
    {$ENTITIES_서비스} 선택한 서비스에 대한 메트릭을 반환합니다.
    {$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