Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

1.2. CLI를 사용하여 설치

다음 섹션에서는 CLI를 사용하여 Loki Operator 및 Red Hat OpenShift Logging Operator를 설치하는 방법을 설명합니다.

1.2.1. CLI를 사용하여 Loki Operator 설치
링크 복사

OpenShift Container Platform 클러스터에 Loki Operator를 설치하여 OpenShift Container Platform CLI(명령줄 인터페이스)를 사용하여 로그 저장소 Loki 를 관리합니다. Loki Operator와 함께 resource Loki Stack을 조정하여 Loki 로그 저장소를 배포하고 구성할 수 있습니다.

사전 요구 사항

  • 관리자 권한이 있습니다.
  • OpenShift CLI(oc)를 설치합니다.
  • 지원되는 오브젝트 저장소에 액세스할 수 있습니다. 예를 들어 AWS S3, Google Cloud Storage, Azure, Swift, Minio 또는 OpenShift Data Foundation입니다.

프로세스

  1. Loki Operator의 Namespace 오브젝트를 생성합니다.

    Namespace 오브젝트의 예

    apiVersion: v1
kind: Namespace
metadata:
  name: openshift-operators-redhat
    1 
    
  labels:
    openshift.io/cluster-monitoring: "true"
    2
    Copy to Clipboard Toggle word wrap

    1
    openshift-operators-redhat 을 네임스페이스로 지정해야 합니다. Operator에 대한 모니터링을 활성화하려면 openshift-operators 네임스페이스가 아닌 openshift-operators-redhat 네임스페이스에서 지표를 스크랩하도록 Cluster Monitoring Operator를 구성합니다. openshift-operators 네임스페이스에 신뢰할 수 없는 커뮤니티 Operator가 포함될 수 있으며, 이로 인해 OpenShift Container Platform 지표와 동일한 이름의 지표를 게시하여 충돌이 발생할 수 있습니다.
    2
    클러스터 모니터링이 openshift-operators-redhat 네임스페이스를 스크랩하도록 하기 위해 표시된 대로 라벨을 지정하는 문자열 값입니다.

  2. 다음 명령을 실행하여 Namespace 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

  3. OperatorGroup 오브젝트를 생성합니다.

    OperatorGroup 오브젝트의 예

    apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: loki-operator
  namespace: openshift-operators-redhat
    1 
    
spec:
  upgradeStrategy: Default
    Copy to Clipboard Toggle word wrap

    1
    openshift-operators-redhat 을 네임스페이스로 지정해야 합니다.

  4. 다음 명령을 실행하여 OperatorGroup 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

  5. Loki Operator에 대한 Subscription 오브젝트를 생성합니다.

    Subscription 개체 예

    apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: loki-operator
  namespace: openshift-operators-redhat
    1 
    
spec:
  channel: stable-6.<y>
    2 
    
  installPlanApproval: Automatic
    3 
    
  name: loki-operator
  source: redhat-operators
    4 
    
  sourceNamespace: openshift-marketplace
    Copy to Clipboard Toggle word wrap

    1
    openshift-operators-redhat 을 네임스페이스로 지정해야 합니다.
    2
    stable-6.<y&gt;를 채널로 지정합니다.
    3
    서브스크립션의 승인 전략이 자동으로 설정된 경우 선택한 채널에서 새 Operator 버전을 사용할 수 있는 즉시 업데이트 프로세스가 시작됩니다. 승인 전략이 Manual 로 설정된 경우 보류 중인 업데이트를 수동으로 승인해야 합니다.
    4
    redhat-operators 를 값으로 지정합니다. OpenShift Container Platform 클러스터가 제한된 네트워크(연결이 끊긴 클러스터)에 설치된 경우 OLM(Operator Lifecycle Manager)을 구성할 때 생성된 CatalogSource 오브젝트의 이름을 지정합니다.

  6. 다음 명령을 실행하여 Subscription 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

  7. LokiStack을 배포하기 위한 네임스페이스 오브젝트를 생성합니다.

    네임스페이스 오브젝트의 예

    apiVersion: v1
kind: Namespace
metadata:
  name: openshift-logging
    1 
    
  labels:
    openshift.io/cluster-monitoring: "true"
    2
    Copy to Clipboard Toggle word wrap

    1
    openshift-logging 네임스페이스는 모든 로깅 워크로드에 전용됩니다.
    2
    클러스터 모니터링이 openshift-logging 네임스페이스를 스크랩하도록 하려면 표시된 대로 레이블을 지정하는 문자열 값입니다.

  8. 다음 명령을 실행하여 namespace 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

  9. 인증 정보를 사용하여 보안을 생성하여 오브젝트 스토리지에 액세스합니다. 예를 들어, 시크릿을 생성하여 AWS(Amazon Web Services) s3에 액세스합니다.

    Secret 오브젝트의 예

    apiVersion: v1
kind: Secret
metadata:
  name: logging-loki-s3
    1 
    
  namespace: openshift-logging
stringData:
    2 
    
  access_key_id: <access_key_id>
  access_key_secret: <secret_access_key>
  bucketnames: <s3_bucket_name>
  endpoint: https://s3.eu-central-1.amazonaws.com
  region: eu-central-1
    Copy to Clipboard Toggle word wrap

    1
    LokiStack에서 사용되는 이름과 일치하도록 logging-loki-s3 이름을 사용합니다.
    2
    보안 콘텐츠에 대한 자세한 내용은 Loki 오브젝트 스토리지 섹션을 참조하십시오.
    중요

    s3 버킷 또는 LokiStack 사용자 정의 리소스(CR)에 정의된 보존 기간이 없으면 로그가 정리되지 않고 s3 스토리지를 채울 수 있습니다.

  10. 다음 명령을 실행하여 Secret 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

  11. LokiStack CR을 생성합니다.

    LokiStack CR의 예

    apiVersion: loki.grafana.com/v1
kind: LokiStack
metadata:
  name: logging-loki
    1 
    
  namespace: openshift-logging
    2 
    
spec:
  managementState: Managed
  limits:
    global:
    3 
    
      retention:
    4 
    
        days: 20 # Set the value as per requirement
  size: 1x.small
    5 
    
  storage:
    schemas:
    - version: v13
      effectiveDate: "<yyyy>-<mm>-<dd>"
    6 
    
    secret:
      name: logging-loki-s3
    7 
    
      type: s3
    8 
    
  storageClassName: <storage_class_name>
    9 
    
  tenants:
    mode: openshift-logging
    10
    Copy to Clipboard Toggle word wrap

    1
    logging-loki 라는 이름을 사용합니다.
    2
    openshift-logging 을 네임스페이스로 지정해야 합니다.
    3
    LokiStack 인스턴스에 적용되는 글로벌 제한을 정의합니다. 스트림 기반 보존 설정에 대한 자세한 내용은 Loki를 사용하여 스트림 기반 보존 활성화를 참조하십시오. 이 필드는 오브젝트 스토리지에 저장된 로그의 보존 기간에는 영향을 미치지 않습니다.
    4
    이 블록이 CR에 추가되면 클러스터에서 보존이 활성화됩니다.
    5
    배포 크기를 지정합니다. Loki의 프로덕션 인스턴스에 지원되는 크기 옵션은 1x.extra- windows ,1x. windows 또는 1x.medium 입니다. 또한 1x.pico 는 로깅 6.1부터 지원됩니다.
    6
    새 설치의 경우 이 날짜는 스키마가 적용되는 시점의 날짜가 되므로 "기타일"과 동일하게 설정해야 합니다.
    7
    로그 저장소 시크릿의 이름을 지정합니다.
    8
    해당 스토리지 유형을 지정합니다.
    9
    임시 스토리지의 스토리지 클래스 이름을 지정합니다. 최상의 성능을 위해서는 블록 스토리지를 할당하는 스토리지 클래스를 지정합니다. oc get storageclasses 명령을 사용하여 클러스터에 사용 가능한 스토리지 클래스를 나열할 수 있습니다.
    10
    openshift-logging 모드는 감사, 인프라 및 애플리케이션과 같은 로그 유형에 대해 테넌트가 생성되는 기본 테넌시 모드입니다. 이를 통해 개별 사용자 및 사용자 그룹에 대한 액세스 제어를 다른 로그 스트림에 사용할 수 있습니다.

  12. 다음 명령을 실행하여 LokiStack CR 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 설치를 확인합니다. 

    $ oc get pods -n openshift-logging
    Copy to Clipboard Toggle word wrap

    출력 예

    $ oc get pods -n openshift-logging
NAME                                               READY   STATUS    RESTARTS   AGE
logging-loki-compactor-0                           1/1     Running   0          42m
logging-loki-distributor-7d7688bcb9-dvcj8          1/1     Running   0          42m
logging-loki-gateway-5f6c75f879-bl7k9              2/2     Running   0          42m
logging-loki-gateway-5f6c75f879-xhq98              2/2     Running   0          42m
logging-loki-index-gateway-0                       1/1     Running   0          42m
logging-loki-ingester-0                            1/1     Running   0          42m
logging-loki-querier-6b7b56bccc-2v9q4              1/1     Running   0          42m
logging-loki-query-frontend-84fb57c578-gq2f7       1/1     Running   0          42m
    Copy to Clipboard Toggle word wrap

1.2.2. CLI를 사용하여 Red Hat OpenShift Logging Operator 설치
링크 복사

OpenShift Container Platform 클러스터에 Red Hat OpenShift Logging Operator를 설치하여 OpenShift CLI(oc)를 사용하여 로그를 수집하고 로그 저장소로 전달합니다.

사전 요구 사항

  • 관리자 권한이 있습니다.
  • OpenShift CLI(oc)를 설치합니다.
  • Loki Operator를 설치 및 구성했습니다.
  • openshift-logging 네임스페이스를 생성했습니다.

프로세스

  1. OperatorGroup 오브젝트를 생성합니다.

    OperatorGroup 오브젝트의 예

    apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: cluster-logging
  namespace: openshift-logging
    1 
    
spec:
  upgradeStrategy: Default
    Copy to Clipboard Toggle word wrap

    1
    openshift-logging 을 네임스페이스로 지정해야 합니다.

  2. 다음 명령을 실행하여 OperatorGroup 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

  3. Red Hat OpenShift Logging Operator에 대한 서브스크립션 오브젝트를 생성합니다.

    Subscription 개체 예

    apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: cluster-logging
  namespace: openshift-logging
    1 
    
spec:
  channel: stable-6.<y>
    2 
    
  installPlanApproval: Automatic
    3 
    
  name: cluster-logging
  source: redhat-operators
    4 
    
  sourceNamespace: openshift-marketplace
    Copy to Clipboard Toggle word wrap

    1
    openshift-logging 을 네임스페이스로 지정해야 합니다.
    2
    stable-6.<y&gt;를 채널로 지정합니다.
    3
    서브스크립션의 승인 전략이 자동으로 설정된 경우 선택한 채널에서 새 Operator 버전을 사용할 수 있는 즉시 업데이트 프로세스가 시작됩니다. 승인 전략이 Manual 로 설정된 경우 보류 중인 업데이트를 수동으로 승인해야 합니다.
    4
    redhat-operators 를 값으로 지정합니다. OpenShift Container Platform 클러스터가 제한된 네트워크(연결이 끊긴 클러스터)에 설치된 경우 OLM(Operator Lifecycle Manager)을 구성할 때 생성된 CatalogSource 오브젝트의 이름을 지정합니다.

  4. 다음 명령을 실행하여 Subscription 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

  5. 로그 수집기에서 사용할 서비스 계정을 생성합니다. 

    $ oc create sa logging-collector -n openshift-logging
    Copy to Clipboard Toggle word wrap

  6. 수집기가 로그를 수집하고 전달할 수 있도록 서비스 계정에 필요한 권한을 할당합니다. 이 예에서 수집기는 인프라 및 애플리케이션 로그 모두에서 로그를 수집할 수 있는 권한이 제공됩니다. 

    $ oc adm policy add-cluster-role-to-user logging-collector-logs-writer -z logging-collector -n openshift-logging
    Copy to Clipboard Toggle word wrap 
    $ oc adm policy add-cluster-role-to-user collect-application-logs -z logging-collector -n openshift-logging
    Copy to Clipboard Toggle word wrap 
    $ oc adm policy add-cluster-role-to-user collect-infrastructure-logs -z logging-collector -n openshift-logging
    Copy to Clipboard Toggle word wrap

  7. ClusterLogForwarder CR을 생성합니다.

    ClusterLogForwarder CR의 예

    apiVersion: observability.openshift.io/v1
kind: ClusterLogForwarder
metadata:
  name: instance
  namespace: openshift-logging
    1 
    
spec:
  serviceAccount:
    name: logging-collector
    2 
    
  outputs:
  - name: lokistack-out
    type: lokiStack
    3 
    
    lokiStack:
      target:
    4 
    
        name: logging-loki
        namespace: openshift-logging
      authentication:
        token:
          from: serviceAccount
    tls:
      ca:
        key: service-ca.crt
        configMapName: openshift-service-ca.crt
  pipelines:
  - name: infra-app-logs
    inputRefs:
    5 
    
    - application
    - infrastructure
    outputRefs:
    - lokistack-out
    Copy to Clipboard Toggle word wrap

    1
    openshift-logging 네임스페이스를 지정해야 합니다.
    2
    이전에 생성한 서비스 계정의 이름을 지정합니다.
    3
    lokiStack 출력 유형을 선택하여 LokiStack 인스턴스에 로그를 보냅니다.
    4
    ClusterLogForwarder 에서 이전에 생성한 LokiStack 인스턴스를 가리킵니다.
    5
    LokiStack 인스턴스에 보낼 로그 출력 유형을 선택합니다.

  8. 다음 명령을 실행하여 ClusterLogForwarder CR 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

검증

  1. 다음 명령을 실행하여 설치를 확인합니다. 

    $ oc get pods -n openshift-logging
    Copy to Clipboard Toggle word wrap

    출력 예

    $ oc get pods -n openshift-logging
NAME                                               READY   STATUS    RESTARTS   AGE
cluster-logging-operator-fb7f7cf69-8jsbq           1/1     Running   0          98m
instance-222js                                     2/2     Running   0          18m
instance-g9ddv                                     2/2     Running   0          18m
instance-hfqq8                                     2/2     Running   0          18m
instance-sphwg                                     2/2     Running   0          18m
instance-vv7zn                                     2/2     Running   0          18m
instance-wk5zz                                     2/2     Running   0          18m
logging-loki-compactor-0                           1/1     Running   0          42m
logging-loki-distributor-7d7688bcb9-dvcj8          1/1     Running   0          42m
logging-loki-gateway-5f6c75f879-bl7k9              2/2     Running   0          42m
logging-loki-gateway-5f6c75f879-xhq98              2/2     Running   0          42m
logging-loki-index-gateway-0                       1/1     Running   0          42m
logging-loki-ingester-0                            1/1     Running   0          42m
logging-loki-querier-6b7b56bccc-2v9q4              1/1     Running   0          42m
logging-loki-query-frontend-84fb57c578-gq2f7       1/1     Running   0          42m
    Copy to Clipboard Toggle word wrap

1.2.3. CLI를 사용하여 로깅 UI 플러그인 설치
링크 복사

로그를 시각화할 수 있도록 CLI(명령줄 인터페이스)를 사용하여 로깅 UI 플러그인을 설치합니다.

사전 요구 사항

  • 관리자 권한이 있습니다.
  • OpenShift CLI(oc)를 설치합니다.
  • Loki Operator를 설치 및 구성했습니다.

프로세스

  1. Cluster Observability Operator를 설치합니다. 자세한 내용은 Cluster Observability Operator 설치를 참조하십시오.

  2. UIPlugin 사용자 정의 리소스(CR)를 생성합니다.

    UIPlugin CR의 예

    apiVersion: observability.openshift.io/v1alpha1
kind: UIPlugin
metadata:
  name: logging
    1 
    
spec:
  type: Logging
    2 
    
  logging:
    lokiStack:
      name: logging-loki
    3 
    
    logsLimit: 50
    timeout: 30s
    schema: otel
    4
    Copy to Clipboard Toggle word wrap

    1
    name 을 logging 로 설정합니다.
    2
    type 을 Logging 으로 설정합니다.
    3
    name 값은 LokiStack 인스턴스의 이름과 일치해야 합니다. openshift-logging 네임스페이스에 LokiStack을 설치하지 않은 경우 lokiStack 구성에 LokiStack 네임스페이스를 설정합니다.
    4
    스키마 는 otel,viaq 또는 select 중 하나입니다. 값이 지정되지 않은 경우 기본값은 viaq 입니다. 선택을 선택하면 쿼리를 실행할 때 UI에서 모드를 선택할 수 있습니다.
    참고

    로깅 UI 플러그인의 알려진 문제 - 자세한 내용은 OU-587 을 참조하십시오.

    • 스키마 기능은 Red Hat OpenShift Logging 4.15 이상에서만 지원됩니다. 이전 버전의 Red Hat OpenShift Logging에서는 로깅 UI 플러그인은 설정할 수 있는 다른 값을 무시하고 viaq 속성만 사용합니다.
    • 관리자가 아닌 사용자는 Red Hat OpenShift 버전 5.8에서 6.2로 로깅하는 otel 특성을 사용하여 로그를 쿼리할 수 없습니다. 이 문제는 향후 로깅 릴리스에서 해결될 예정입니다. (LOG-6589)
    • Red Hat OpenShift 버전 5.9 로깅에서 severity_text Otel 속성은 설정되지 않습니다.

  3. 다음 명령을 실행하여 UIPlugin CR 오브젝트를 적용합니다. 

    $ oc apply -f <filename>.yaml
    Copy to Clipboard Toggle word wrap

검증

  1. Red Hat OpenShift Logging 웹 콘솔에 액세스하고 팝업 메시지가 이를 수행하도록 지시하는 경우 페이지를 새로 고칩니다.
  2. LogQL 쿼리를 실행할 수 있는 모니터링 로그 패널로 이동합니다. 특정 Pod의 집계 로그 탭에서 개별 Pod의 로그 를 쿼리할 수도 있습니다.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat