이 문서는 머신 ID tbot 에이전트가 수집하는 텔레메트리가 무엇인지, 왜 이러한 텔레메트리를 수집하고자 하는지 및 선택하는 방법에 대해 설명합니다.

왜?

머신 ID는 Teleport 제품의 새로운 부분으로, 사람들이 가진 사용 사례의 종류를 식별하는 데 도움이 됩니다. 이를 통해 더 일반적인 사용 우선순위를 정할 수 있습니다. 사용자가 직접 대화하여 이러한 정보를 수집하려고 노력하지만, 제품이 실제로 사용되고 있는 전반적인 개요를 가지는 것이 더 많은 정보를 기반으로 한 결정을 내리는 데 도움이 되며, 우리의 결정이 소수의 사용자에 의해 전적으로 영향을 받지 않도록 할 수 있습니다.

익명 텔레메트리

익명 텔레메트리는 현재 tbot에서 지원되는 유일한 모드입니다. 이는 수집된 데이터에 다음을 식별하는 정보가 포함되지 않음을 의미합니다:

• tbot이 실행되고 있는 특정 머신
• tbot이 연결하는 클러스터
• tbot이 연결하는 호스트, 응용 프로그램, 데이터베이스 및 Kubernetes 클러스터
• tbot을 구성한 사용자

앞으로 머신 ID의 익명 텔레메트리에 추가 사건을 도입하는 경우, 위의 지침을 준수하고 새 정보를 수집한 경우 변경 사항이 변경 로그에 명시적으로 포함되도록 할 것입니다.

특정 머신에서 tbot이 실행되고 있는 것을 고유하게 식별하는 데이터는 수집하지 않지만, 머신에 설치된 아키텍처 및 운영 체제에 대한 일반적인 정보는 수집할 수 있습니다.

여러 번의 시작을 통틀어 tbot 설치를 식별하는 고유한 ID를 할당하지 않습니다. 이는 tbot이 머신에 설치된 기간을 확인하거나 특정 호스트에서 tbot 구성에 대한 변경 사항을 시간에 따라 추적할 수 없음을 의미합니다.

단일 tbot 시작에서 발생하는 사건을 식별하는 고유한 ID를 할당합니다(이것은 "세션"이라고 불릴 수 있습니다). 이를 통해 여러 사건을 연결하고 tbot이 시작된 후 얼마나 오랫동안 발생했는지를 확인할 수 있습니다.

옵트아웃/옵트인

tbot의 익명 텔레메트리는 엄격하게 옵트인입니다.

이 텔레메트리에 참여하려면 옵트인 환경 변수를 1로 설정하세요:

export TELEPORT_ANONYMOUS_TELEMETRY=1
tbot start ...

이 환경 변수를 사용하여 명시적으로 이 텔레메트리에서 옵트아웃할 수도 있습니다. 값을 0으로 설정하세요:

export TELEPORT_ANONYMOUS_TELEMETRY=0
tbot start ...

이 환경 변수가 구성되지 않은 경우, tbot은 기본적으로 익명 텔레메트리를 수집하지 않습니다.

사건들

현재 익명 텔레메트리는 tbot 시작 시 단일 사건을 제출합니다.

이 사건은 tbot.start라고 하며, 다음 속성이 포함됩니다:

• tbot.run_mode: [one-shot, daemon] 중 하나로 tbot이 --oneshot로 호출되었는지에 따라 다름
• tbot.version: 실행 중인 tbot의 버전
• tbot.join_type: 구성된 조인 방법 유형(예: token 또는 github)
• tbot.helper: tbot을 시작한 헬퍼의 이름(사용된 경우). 예: gha:teleport-actions/auth
• tbot.helper_version: tbot을 시작한 헬퍼의 버전(사용된 경우)
• tbot.destinations_other: 데이터베이스 서비스, Kubernetes 서비스 또는 애플리케이션 서비스와 관련이 없는 구성된 목적지의 수
• tbot.destinations_database: 구성된 데이터베이스 서비스 목적지의 수
• tbot.destinations_kubernetes: 구성된 Kubernetes 서비스 목적지의 수
• tbot.destinations_application: 구성된 애플리케이션 서비스 목적지의 수