모니터링 개요

Spanner Omni의 모니터링은 Spanner의 모니터링과 유사하게 작동하지만 몇 가지 예외가 있습니다. 이 문서에서는 이러한 예외를 설명하고 Spanner 모니터링 문서의 관련 정보를 안내합니다. Spanner 문서를 읽으면서 이 페이지를 다시 참조하여 Spanner Omni의 차이점을 확인하세요.

지원되지 않는 Spanner 기능

Spanner Omni는 엔드 투 엔드 추적을 제외한 모든 Spanner 모니터링 기능을 지원합니다.

원격 분석 신호 캡처

성능, 사용량, 잠재적 문제에 대한 유용한 정보를 얻으려면 Spanner Omni 데이터베이스에서 신호를 캡처하면 됩니다.

신호 캡처 개요

원격 분석 신호는 데이터베이스의 성능을 파악하는 데 도움이 됩니다.

Spanner Omni에는 다음 신호를 사용할 수 있습니다.

신호 유형 설명
측정항목 데이터베이스 상태 또는 성능에 대한 수치 데이터입니다.
로그 일정 기간 동안 생성된 시스템 활동 기록입니다.
Trace 애플리케이션을 통한 요청 경로
통계 테이블 데이터베이스 정보를 쿼리하기 위한 기본 제공 테이블입니다.

Spanner Omni에서는 클라이언트 측 측정항목이 지원되지 않습니다. 클라이언트 측 측정항목에는 GFE 측정항목의 지연 시간, 클라이언트 측 측정항목 수집, 커스텀 클라이언트 측 측정항목 수집이 포함됩니다. 자세한 내용은 Spanner 문서의 신호 캡처 개요를 참조하세요.

Trace 수집

trace는 애플리케이션을 통과하는 요청의 경로를 나타냅니다. trace를 사용하면 요청 흐름을 따라가면서 문제의 근본 원인을 파악할 수 있습니다. 예를 들어 추적은 클라이언트가 RPC 요청을 보내고 받은 시간의 타임스탬프가 포함된 스팬과 같이 클라이언트의 모든 요청에 대한 정보를 제공할 수 있습니다. 이를 통해 데이터베이스 요청을 모니터링하고 디버깅할 수 있습니다.

자세한 내용은 Spanner 문서의 Trace 컬렉션 개요를 참조하세요.

OpenTelemetry를 사용하여 trace 수집 설정

OpenTelemetry API를 사용하여 trace를 내보내도록 Spanner 클라이언트 라이브러리를 구성할 수 있습니다. 이 프로세스에는 OpenTelemetry SDK를 구성하고 내보내기 도구를 사용하여 trace 데이터를 모니터링 가능성 백엔드로 전송하는 작업이 포함됩니다.

Spanner Omni에서는 클라이언트 측 추적을 사용할 수 없습니다.

자세한 내용은 Spanner 문서의 OpenTelemetry를 사용하여 trace 수집 설정을 참조하세요.

수집기로 서버 trace 내보내기

Spanner Omni 서버는 OTLP 형식의 자체 trace를 Jaeger와 같은 trace 수집기로 내보낼 수 있습니다. 수집기를 설정하려면 다음 중 하나를 수행합니다.

  • VM에서 서버를 시작하기 전에 SPANNER_TRACE_EXPORTER_ENDPOINT 환경 변수를 설정합니다. 자세한 내용은 trace 수집 및 분석을 참조하세요.

  • Kubernetes에서 deployment.traceExporterEndpoint Helm 값을 설정합니다.

    helm upgrade spanner-omni oci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni \
        --version 2.0.0 \
        --namespace NAMESPACE \
        --reuse-values \
        --set deployment.traceExporterEndpoint=dns:///COLLECTOR_HOST:COLLECTOR_PORT
    

    monitoring.enabled=true로 Helm 차트를 설치하고 deployment.traceExporterEndpoint를 설정하지 않으면 서버는 Helm 차트가 설치하는 Jaeger 수집기로 trace를 내보냅니다(dns:///jaeger.monitoring.svc.cluster.local:4317).

서버는 TLS 없이 Unix 도메인 소켓 엔드포인트(unix: 또는 unix-abstract:로 시작하는 대상)로 trace를 내보냅니다. trace가 호스트를 벗어나지 않기 때문입니다. 서버는 localhost의 수집기, 루프백 IP 주소, 다른 포드 또는 서비스, Kubernetes 노드의 IP 주소(예: DaemonSet 수집기의 경우 $HOST_IP:4317)를 포함하여 다른 모든 수집기를 원격으로 취급합니다.

TLS를 통해 trace 내보내기

Spanner Omni 출시 버전 2026.r4-lts.3부터 TLS 암호화가 적용된 배포의 서버는 TLS를 통해서만 원격 수집기로 trace를 내보냅니다. 이전 출시 버전에서는 trace를 일반 텍스트로 원격 수집기로 내보내고 TLS trace 내보내기를 지원하지 않습니다. 원격 수집기로 trace를 내보내려면 다음을 수행합니다.

  1. trace 내보내기 도구 엔드포인트에서 수집기 호스트 이름에 대한 trace 수집기 CA(ca-otlp.crt) 및 수집기 인증서를 만듭니다.

  2. 수집기 인증서를 사용하여 수집기의 OTLP gRPC 수신자에서 TLS를 사용 설정합니다. 다음 예시에서는 otlp-certs 디렉터리의 collector.crt 및 collector.key 파일을 사용합니다. 인증서를 만든 디렉터리에서 명령어를 실행하거나 otlp-certs를 해당 디렉터리의 전체 경로로 바꿉니다.

    • VM의 Jaeger v1(jaeger-all-in-one):

      export COLLECTOR_OTLP_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_CERT=otlp-certs/collector.crt
      export COLLECTOR_OTLP_GRPC_TLS_KEY=otlp-certs/collector.key
      jaeger-all-in-one
      

      Jaeger v2는 구성 파일에서 TLS를 구성합니다. 자세한 내용은 Jaeger 보안 문서를 참조하세요.

    • Helm 차트가 monitoring.enabled=true로 설치하는 Jaeger 수집기의 경우 monitoring 네임스페이스에 jaeger-tls라는 TLS 보안 비밀을 만듭니다.

      kubectl create secret tls jaeger-tls -n monitoring \
          --cert=otlp-certs/collector.crt --key=otlp-certs/collector.key
      

      Helm 차트 버전 2.0.0부터 Jaeger 수집기는 jaeger-tls 보안 비밀을 사용하여 TLS 암호화가 적용된 배포에서 기본적으로 TLS를 제공합니다. 이러한 배포에서 deployment.traceExporterEndpoint를 자체 수집기로 설정하지 않는 한 보안 비밀이 없으면 helm install 및 helm upgrade가 실패합니다. 다른 이름의 보안 비밀을 사용하려면 monitoring.jaeger.tls.secretName를 설정합니다. Jaeger는 monitoring.jaeger.tls.reloadInterval(기본값: 1h)마다 인증서를 새로고침하므로 다시 시작하지 않고도 인증서를 순환할 수 있습니다.

      Helm 차트 버전 2.0.0에는 Spanner Omni 출시 버전 2026.r4-lts.3 이상이 필요합니다. 이전 출시 버전에서는 Helm 차트 버전 1.x를 사용합니다.

  3. 다른 인증서와 함께 ca-otlp.crt를 서버에 배포합니다.

  4. 서버를 시작하거나 다시 시작합니다. 서버는 시작 시 ca-otlp.crt가 있는지 여부에 따라 TLS를 사용할지 여부를 결정하므로 파일을 추가하거나 삭제하면 다시 시작한 후에만 적용됩니다. 인증서 순환과 같은 기존 파일의 변경사항은 다시 시작하지 않아도 적용됩니다.

    Kubernetes에서 tls-certs 보안 비밀에 키를 추가해도 서버가 다시 시작되지 않습니다. 다시 시작하려면 다음 명령어를 실행합니다.

    kubectl rollout restart statefulset -n NAMESPACE \
        -l app.kubernetes.io/instance=spanner-omni
    

서버는 수집기의 인증서가 ca-otlp.crt에서 발급되었고 trace 내보내기 도구 엔드포인트의 호스트 이름과 일치하는지 확인합니다. 서버는 클라이언트 인증서를 제시하지 않으므로 클라이언트 인증서가 필요하도록 수집기를 구성하지 마세요. ca-otlp.crt가 있으면 서버는 TLS 암호화가 없는 배포에서 원격 수집기에 TLS를 사용합니다.

삭제된 trace 모니터링

TLS 암호화가 적용된 배포에서 ca-otlp.crt가 없으면 서버가 원격 수집기로 trace를 내보내지 않습니다. 서버는 구성을 수정하는 방법을 설명하는 비율 제한 경고를 로깅하고 opentelemetry_dropped_spans Prometheus 측정항목에서 삭제된 trace를 계산하며 reason 라벨은 secure_mode로 설정됩니다.

배포를 만들기 전에는 서버에서 배포가 TLS 암호화를 사용하는지 확인할 수 없습니다. 그때까지 ca-otlp.crt가 없으면 서버는 트레이스를 원격 수집기로 내보내지 않고 reason 라벨을 deployment_state_unavailable로 설정하여 계산합니다.

ca-otlp.crt가 유효한 CA 인증서가 아니거나 수집기의 인증서가 ca-otlp.crt에서 발급되지 않았거나 trace 내보내기 도구 엔드포인트의 호스트 이름과 일치하지 않으면 구성을 수정할 때까지 수집기에 대한 연결이 실패합니다. opentelemetry_dropped_spans 측정항목은 이러한 실패를 계산하지 않습니다. 이를 감지하려면 서버 로그에서 TLS 핸드셰이크 및 trace 내보내기 오류를 확인하세요. 또한 ca-otlp.crt에 PEM 인증서가 포함되어 있지 않으면 서버가 시작 시 경고를 로깅합니다.

감사 로그

감사 로그는 보안 및 규정 준수를 위해 관리 변경사항과 데이터 액세스 이벤트를 추적합니다. 감사 로그를 사용하여 처리 기간 필드를 참조하여 요청 지연 시간을 모니터링할 수 있습니다. 자세한 내용은 감사 로그를 참조하세요.

인스턴스 모니터링

인스턴스를 모니터링하여 예상대로 작동하는지 확인하고 잠재적인 문제를 해결합니다.

통계를 사용하여 인스턴스 성능 모니터링

시스템 통계 대시보드는 지연 시간, CPU 사용률, 스토리지, 처리량, 기타 성능 통계에 대한 차트와 측정항목을 제공합니다. 이 대시보드를 사용하여 Spanner Omni 인스턴스와 데이터베이스를 모니터링할 수 있습니다. 자세한 내용은 Spanner 문서의 시스템 통계로 인스턴스 모니터링을 참조하세요.

다음 단계