5.7. Telemetry 모듈
Telemetry 모듈은 스토리지 클러스터에 대한 데이터를 전송하여 Ceph 사용 방법과 작업 중에 발생하는 문제를 이해하는 데 도움이 됩니다. 데이터는 공용 대시보드에 시각화되어 보고되는 클러스터 수, 총 용량 및 OSD 수, 버전 배포 추세에 대한 요약 통계를 확인합니다.
채널
원격 분석 보고서는 각각 다른 유형의 정보를 가진 다양한 채널로 나뉩니다. Telemetry가 활성화되면 개별 채널을 켜거나 끌 수 있습니다.
다음은 4개의 다른 채널입니다.
Basic
- 기본값은on
입니다. 이 채널은 다음 정보를 포함하는 클러스터에 대한 기본 정보를 제공합니다.- 클러스터의 용량입니다.
- 모니터, 관리자, OSD, MDSs, 오브젝트 게이트웨이 또는 기타 데몬의 수입니다.
- 현재 사용 중인 소프트웨어 버전입니다.
- RADOS 풀 및 Ceph 파일 시스템의 수 및 유형입니다.
- 기본값(값이 아님)에서 변경된 구성 옵션의 이름입니다.
crash
- 기본값은on
입니다. 이 채널은 다음 정보를 포함하는 데몬 충돌에 대한 정보를 제공합니다.- 데몬 유형입니다.
- 데몬의 버전입니다.
- 운영 체제, OS 배포 및 커널 버전입니다.
- Ceph 코드에서 크래시가 발생한 위치를 식별하는 스택 추적입니다.
-
device
- 기본값은
입니다. 이 채널은 익명화된 SMART 메트릭을 포함하는 장치 메트릭에 대한 정보를 제공합니다. -
id
ENT - 기본값은OFF
입니다. 이 채널은 클러스터 설명과 같은 클러스터에 대한 사용자 제공 식별 정보 및 연락처 이메일 주소를 제공합니다. perf
- 기본값은OFF
입니다. 이 채널은 클러스터의 다양한 성능 지표를 제공하며, 이는 다음에 사용할 수 있습니다.- 전체 클러스터 상태를 표시합니다.
- 워크로드 패턴을 식별합니다.
- 대기 시간, 제한, 메모리 관리 및 기타 유사한 문제에 대한 문제를 해결합니다.
- 데몬을 통해 클러스터 성능을 모니터링합니다.
보고된 데이터에는 풀 이름, 오브젝트 이름, 오브젝트 콘텐츠, 호스트 이름 또는 장치 일련 번호와 같은 중요한 데이터가 포함되어 있지 않습니다.
클러스터 배포 방법, Ceph 버전, 호스트 배포 및 Ceph 사용 방식을 보다 잘 이해하는 데 도움이 되는 기타 매개 변수에 대한 카운터 및 통계가 포함되어 있습니다.
데이터는 안전하며 https://telemetry.ceph.com 로 전송됩니다.
Telemetry 활성화
채널을 활성화하기 전에 Telemetry가 켜져 있는지 확인합니다.
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
간격
모듈은 기본적으로 24시간마다 새 보고서를 컴파일하고 보냅니다.
간격을 조정합니다.
구문
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