5.7. Telemetry 모듈

• Basic - 기본값은 on 입니다. 이 채널은 다음 정보를 포함하는 클러스터에 대한 기본 정보를 제공합니다.

  • 클러스터의 용량입니다.
  • 모니터, 관리자, OSD, MDSs, 오브젝트 게이트웨이 또는 기타 데몬의 수입니다.
  • 현재 사용 중인 소프트웨어 버전입니다.
  • RADOS 풀 및 Ceph 파일 시스템의 수 및 유형입니다.
  • 기본값(값이 아님)에서 변경된 구성 옵션의 이름입니다.

• crash - 기본값은 on 입니다. 이 채널은 다음 정보를 포함하는 데몬 충돌에 대한 정보를 제공합니다.

  • 데몬 유형입니다.
  • 데몬의 버전입니다.
  • 운영 체제, OS 배포 및 커널 버전입니다.
  • Ceph 코드에서 크래시가 발생한 위치를 식별하는 스택 추적입니다.
• device - 기본값 은 입니다. 이 채널은 익명화된 SMART 메트릭을 포함하는 장치 메트릭에 대한 정보를 제공합니다.
• id ENT - 기본값은 OFF 입니다. 이 채널은 클러스터 설명과 같은 클러스터에 대한 사용자 제공 식별 정보 및 연락처 이메일 주소를 제공합니다.

• perf - 기본값은 OFF 입니다. 이 채널은 클러스터의 다양한 성능 지표를 제공하며, 이는 다음에 사용할 수 있습니다.

  • 전체 클러스터 상태를 표시합니다.
  • 워크로드 패턴을 식별합니다.
  • 대기 시간, 제한, 메모리 관리 및 기타 유사한 문제에 대한 문제를 해결합니다.
  • 데몬을 통해 클러스터 성능을 모니터링합니다.

• Telemetry를 활성화합니다.

  ceph telemetry on

채널 활성화 및 비활성화

• 개별 채널을 활성화 또는 비활성화합니다.

  ceph telemetry enable channel basic
  ceph telemetry enable channel crash
  ceph telemetry enable channel device
  ceph telemetry enable channel ident
  ceph telemetry enable channel perf
  
  ceph telemetry disable channel basic
  ceph telemetry disable channel crash
  ceph telemetry disable channel device
  ceph telemetry disable channel ident
  ceph telemetry disable channel perf

• 여러 채널을 활성화하거나 비활성화합니다.

  ceph telemetry enable channel basic crash device ident perf
  ceph telemetry disable channel basic crash device ident perf

• 모든 채널을 함께 활성화 또는 비활성화합니다.

  ceph telemetry enable channel all
  ceph telemetry disable channel all

샘플 보고서

• 언제든지 보고된 데이터를 검토하려면 샘플 보고서를 생성합니다.

  ceph telemetry show

• Telemetry가 꺼져 있는 경우 샘플 보고서를 미리 봅니다.

  ceph telemetry preview

  수백 개의 OSD 이상이 있는 스토리지 클러스터에 대한 샘플 보고서를 생성하는 데 시간이 오래 걸립니다.

• 개인 정보를 보호하기 위해 장치 보고서가 별도로 생성되고 호스트 이름 및 장치 일련 번호와 같은 데이터는 익명화됩니다. 장치 Telemetry는 다른 끝점으로 전송되며 장치 데이터를 특정 클러스터와 연결하지 않습니다. 장치 보고서를 보려면 다음 명령을 실행합니다.

  ceph telemetry show-device

• Telemetry가 꺼져 있는 경우 샘플 장치 보고서를 미리 봅니다.

  ceph telemetry preview-device

• : : 에 Telemetry가 있는 두 보고서의 단일 출력을 가져옵니다.

  ceph telemetry show-all

• Telemetry off 가 포함된 두 보고서의 단일 출력을 가져옵니다.

  ceph telemetry preview-all

• 채널별 샘플 보고서를 생성합니다.

  구문

  ceph telemetry show CHANNEL_NAME

• 채널별 샘플 보고서의 프리뷰를 생성합니다.

  구문

  ceph telemetry preview CHANNEL_NAME

• 컬렉션을 나열합니다.

  ceph telemetry collection ls

• 등록된 컬렉션과 사용 가능한 새 컬렉션 간의 차이점을 참조하십시오.

  ceph telemetry diff

• 최신 컬렉션에 등록합니다.

  구문

  ceph telemetry on
  ceph telemetry enable channel CHANNEL_NAME

• 간격을 조정합니다.

  구문

  ceph config set mgr mgr/telemetry/interval INTERVAL

  예제

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/interval 72

  이 예제에서는 3일(72시간)마다 보고서가 생성됩니다.

상태

• 현재 구성을 확인합니다.

  ceph telemetry status

Telemetry 수동 전송

• 임시로 Telemetry 데이터를 보냅니다.

  ceph telemetry send

  Telemetry가 비활성화된 경우 ceph telemetry send 명령에 --license sharing-1-0 을 추가합니다.

프록시를 통해 Telemetry 전송

• 클러스터가 구성된 Telemetry 끝점에 직접 연결할 수 없는 경우 HTTP/HTTPs 프록시 서버를 구성할 수 있습니다.

  구문

  ceph config set mgr mgr/telemetry/proxy PROXY_URL

  예제

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080

  user pass를 명령에 포함할 수 있습니다.

  예제

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080

연락처 및 설명

• 선택 사항: 보고서에 연락처 및 설명을 추가합니다.

  구문

  ceph config set mgr mgr/telemetry/contact '_CONTACT_NAME_'
  ceph config set mgr mgr/telemetry/description '_DESCRIPTION_'
  ceph config set mgr mgr/telemetry/channel_ident true

  예제

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/contact 'John Doe <john.doe@example.com>'
  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/description 'My first Ceph cluster'
  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/channel_ident true

  ident 플래그가 활성화되면 해당 세부 정보가 리더보드에 표시되지 않습니다.

Leaderboard

• 공용 대시보드의 리더 보드에 참여하십시오.

  예제

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/leaderboard true

  leaderboard에는 스토리지 클러스터에 대한 기본 정보가 표시됩니다. 이 보드에는 총 스토리지 용량과 OSD 수가 포함됩니다.

Telemetry 비활성화

• 언제든지 Telemetry를 비활성화합니다.

  예제

  ceph telemetry off