이 문서는 머신 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 : --oneshot 옵션으로 호출되었는지에 따라 [one-shot , daemon ] 중 하나
• 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 : 구성된 애플리케이션 서비스 목적지의 수