설정하기

주의

OpenTelemetry 모니터링은 베타 버전으로 예기치 않은 오류가 발생할 수 있습니다. 중요한 데이터나 운영 환경에서는 사용하는 것을 권장하지 않습니다. 피드백이나 문제점이 발생하면 지원 팀(support@whatap.io)으로 문의하세요.

OpenTelemetry로부터 다양한 지표를 수집하고 처리하도록 에이전트를 설정할 수 있습니다.

에이전트

otel_grpc_server_enabled Boolean

기본값 true

OpenTelemetry protocol(OTLP)를 통해 전달되는 데이터를 수신하기 위한 Grpc 서버를 활성화합니다.
otel_grpc_server_port String

기본값 6600

Grpc 서버의 Listen 포트입니다.

노트
포트 번호를 변경 후에는 whatap-otel 서비스를 재시작해야 합니다.
otel_grpc_server_gzip_enabled Boolean

기본값 true

Grpc 서버에서 읽는 데이터의 암호화로 gzip을 활성화합니다.
debug_otel_grpc_server_enabled Boolean

기본값 false

OpenTelemetry Trace 데이터 처리에 관련된 디버그 로그의 출력을 활성화합니다.

Trace

OpenTelemetry Trace 데이터 처리와 관련한 에이전트 설정 옵션입니다. 와탭은 OpenTelemetry Trace 구성 요소인 Span의 attributes 객체로부터 값을 가져와 모니터링 정보로 활용합니다.

Span의 attributes 객체가 와탭의 에이전트 설정과 어떻게 연관되는지 다음 코드를 참조하세요.

OpenTelemetry - Span example
{
    "name": "/v1/sys/health",
    "context": {
        "trace_id": "7bba9f33312b3dbb8b2c2c62bb7abe2d",
        "span_id": "086e83747d0e381e"
    },
    "parent_id": "",
    "start_time": "2021-10-22 16:04:01.209458162 +0000 UTC",
    "end_time": "2021-10-22 16:04:01.209514132 +0000 UTC",
    "status_code": "STATUS_CODE_OK",
    "status_message": "",
    "attributes": {
        "net.transport": "IP.TCP",
        "net.peer.ip": "172.17.0.1",
        "net.peer.port": "51820",
        "net.host.ip": "10.177.2.152",
        "net.host.port": "26040",
        "http.method": "GET",
        "http.target": "/v1/sys/health",
        "http.server_name": "mortar-gateway",
        "http.route": "/v1/sys/health",
        "http.user_agent": "Consul Health Check",
        "http.scheme": "http",
        "http.host": "10.177.2.152:26040",
        "http.flavor": "1.1"
    },
    "events": [
        {
            "name": "",
            "message": "OK",
            "timestamp": "2021-10-22 16:04:01.209512872 +0000 UTC"
        }
    ]
}

whatap.conf
otel_attr_tx_host_keys=http.host
otel_attr_tx_method_keys=http.method
otel_attr_tx_useragent_keys=http.user_agent

노트

와탭의 트레이스 분석과 관련한 자세한 내용은 다음 문서를 참조하세요.
OpenTelemetry의 Trace 데이터 처리에 대한 자세한 내용은 다음 링크를 참조하세요.
OpenTelemetry에서 제공하는 속성(attributes)에 대한 자세한 내용은 다음 링크를 참조하세요.
- Database
- Error
- Host
- HTTP
- Network
- URL
- User agent

otel_trace_server_enabled Boolean

기본값 true

OpenTelemetry Trace 데이터 처리를 활성화합니다.
otel_trace_queue_size Int

기본값 5000

OpenTelemetry Trace 데이터 처리를 위한 큐 크기를 설정합니다.
otel_span_collector_max Int

기본값 100000

OpenTelemetry Trace 데이터의 Span 데이터 버퍼의 최대 크기(개수)를 지정합니다.
otel_attr_dbcon_keys String

기본값 sql.system,db.connection_string,db.system

DB Connection 정보로 활용할 속성 이름을 입력하세요. 해당 정보를 활용해 와탭에서는 DB Connection 스텝으로 표시합니다.
otel_attr_sql_keys String

기본값 db.statement,sql.query

SQL 쿼리 정보로 활용할 속성 이름을 입력하세요. 해당 정보를 활용해 와탭에서는 SQL 스텝으로 표시합니다.
otel_attr_httpc_keys String

기본값 url.full,http.url,http.target

HTTP call 정보로 활용할 속성 이름을 입력하세요. 해당 정보를 활용해 와탭에서는 HTTP Call 스텝으로 표시합니다.
otel_attr_tx_url_keys String

기본값 http.url,http.route,http.target,tyk.api.path,http.url

트랜잭션의 서비스 URL 정보로 활용할 속성 이름을 입력하세요.
otel_attr_tx_host_keys String

기본값 http.host

트랜잭션의 호스트 정보로 활용할 속성 이름을 입력하세요.
otel_attr_tx_method_keys String

기본값 http.method,http.request.method

HTTP Method 정보로 활용할 속성 이름을 입력하세요.
otel_attr_tx_status_keys String

기본값 http.status_code

트랜잭션의 HTTP 상태 코드 정보로 활용할 속성 이름을 입력하세요.
otel_attr_tx_useragent_keys String

기본값 http.user_agent

트랜잭션의 User-Agent 정보로 활용할 속성 이름을 입력하세요.
otel_attr_tx_clientip_keys String

기본값 net.peer.ip,net.socket.peer.addr

트랜잭션의 클라이언트 IP 정보로 활용할 속성 이름을 입력하세요.
otel_attr_tx_referer_keys String

트랜잭션의 HTTP Referer 정보로 활용할 속성 이름을 입력하세요.
otel_attr_error_keys String

기본값 error.type

트랜잭션의 에러 정보로 활용할 속성 이름을 입력하세요.

Metric

OpenTelemetry Metric 데이터 처리와 관련한 에이전트 설정 옵션입니다.

노트

OpenTelemetry의 Metric 데이터 처리에 대한 자세한 내용은 다음 링크를 참조하세요.

otel_metric_server_enabled Boolean

기본값 false

OpenTelemetry Metric 데이터 처리를 활성화합니다.
otel_metric_queue_size Int

기본값 5000

Opentelemetry Metric 데이터 처리를 위한 큐 크기를 설정합니다.

Log

OpenTelemetry Log 데이터 처리와 관련한 에이전트 설정 옵션입니다.

노트

OpenTelemetry의 Log 데이터 처리에 대한 자세한 내용은 다음 링크를 참조하세요.

otel_log_server_enabled Boolean

기본값 false

Opentelemetry Log 데이터 처리를 활성화합니다.
otel_log_queue_size Int

기본값 5000

Opentelemetry Log 데이터 처리를 위한 큐 크기를 설정합니다.

에이전트​

Trace​

Metric​

Log​

에이전트

Trace

Metric

Log