검색

4.5. Prometheus의 쿼리 로그 파일 활성화

download PDF

엔진에서 실행한 모든 쿼리를 로그 파일에 작성하도록 Prometheus를 구성할 수 있습니다. 기본 플랫폼 모니터링과 사용자 정의 워크로드 모니터링을 위해 이를 수행할 수 있습니다.

중요

로그 순환은 지원되지 않으므로 문제를 해결해야 하는 경우에만 이 기능을 일시적으로 활성화합니다. 문제 해결을 마친 후 ConfigMap 오브젝트에 대한 변경 사항을 되돌리려면 기능을 활성화하여 쿼리 로깅을 비활성화합니다.

사전 요구 사항

  • OpenShift CLI(oc)가 설치되어 있습니다.
  • openshift-monitoring 프로젝트에서 Prometheus의 쿼리 로그 파일 기능을 활성화하는 경우:

    • cluster-admin 클러스터 역할의 사용자로 클러스터에 액세스할 수 있습니다.
    • cluster-monitoring-config ConfigMap 오브젝트를 생성하셨습니다.
  • openshift-user-workload-monitoring 프로젝트에서 Prometheus의 쿼리 로그 파일 기능을 활성화하는 경우:

    • cluster-admin 클러스터 역할의 사용자로 또는 openshift-user-workload-monitoring 프로젝트에서 user-workload-monitoring-config-edit 역할의 사용자로 클러스터에 액세스할 수 있습니다.
    • user-workload-monitoring-config ConfigMap 오브젝트가 생성되어 있습니다.

프로세스

  • openshift-monitoring 프로젝트에서 Prometheus의 쿼리 로그 파일을 설정하려면 다음을 수행합니다.

    1. openshift-monitoring 프로젝트에서 cluster-monitoring-config ConfigMap 오브젝트를 편집합니다.

      $ oc -n openshift-monitoring edit configmap cluster-monitoring-config
    2. data/config.yaml 아래에 prometheusK8squeryLogFile: <path >를 추가합니다.

      apiVersion: v1
      kind: ConfigMap
      metadata:
        name: cluster-monitoring-config
        namespace: openshift-monitoring
      data:
        config.yaml: |
          prometheusK8s:
            queryLogFile: <path> 1
      1
      쿼리가 기록될 파일의 전체 경로입니다.
    3. 파일을 저장하여 변경 사항을 적용합니다.

      주의

      모니터링 구성 맵에 변경 사항을 저장하면 관련 프로젝트의 Pod 및 기타 리소스가 재배포될 수 있습니다. 해당 프로젝트에서 실행 중인 모니터링 프로세스도 다시 시작할 수 있습니다.

    4. 구성 요소의 포드가 실행 중인지 확인합니다. 다음 샘플 명령은 openshift-monitoring 프로젝트의 Pod 상태를 나열합니다.

      $ oc -n openshift-monitoring get pods
    5. 쿼리 로그를 읽습니다.

      $ oc -n openshift-monitoring exec prometheus-k8s-0 -- cat <path>
      중요

      기록된 쿼리 정보를 검사한 후 구성 맵에서 설정을 되돌립니다.

  • openshift-user-workload-monitoring 프로젝트에서 Prometheus의 쿼리 로그 파일을 설정하려면 다음을 수행합니다.

    1. openshift-user-workload-monitoring 프로젝트에서 user-workload-monitoring-config ConfigMap 오브젝트를 편집합니다.

      $ oc -n openshift-user-workload-monitoring edit configmap user-workload-monitoring-config
    2. data/config.yaml 아래에 prometheusqueryLogFile: <path >를 추가합니다.

      apiVersion: v1
      kind: ConfigMap
      metadata:
        name: user-workload-monitoring-config
        namespace: openshift-user-workload-monitoring
      data:
        config.yaml: |
          prometheus:
            queryLogFile: <path> 1
      1
      쿼리가 기록될 파일의 전체 경로입니다.
    3. 파일을 저장하여 변경 사항을 적용합니다.

      참고

      클러스터 관리자가 사용자 정의 프로젝트에 대한 모니터링을 활성화하지 않는 한 user-workload-monitoring-config ConfigMap 오브젝트에 적용되는 구성이 활성화되어 있지 않습니다.

      주의

      모니터링 구성 맵에 변경 사항을 저장하면 관련 프로젝트의 Pod 및 기타 리소스가 재배포될 수 있습니다. 해당 프로젝트에서 실행 중인 모니터링 프로세스도 다시 시작할 수 있습니다.

    4. 구성 요소의 포드가 실행 중인지 확인합니다. 다음 예제 명령은 openshift-user-workload-monitoring 프로젝트의 Pod 상태를 나열합니다.

      $ oc -n openshift-user-workload-monitoring get pods
    5. 쿼리 로그를 읽습니다.

      $ oc -n openshift-user-workload-monitoring exec prometheus-user-workload-0 -- cat <path>
      중요

      기록된 쿼리 정보를 검사한 후 구성 맵에서 설정을 되돌립니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.