인사이트와 애널리틱스
인사이트와 애널리틱스 (Insights and analytics)
Docker Verified Publisher(DVP)와 Docker-Sponsored Open Source(DSOS) 이미지의 사용 메트릭인 인사이트·애널리틱스 데이터를 보고 내보내는 방법을 배워볼게요.
출처: 문서
본문
입새이트와 분석은 Docker Hub의 Docker Verified Publisher(DVP) 및 Docker-Sponsored Open Source(DSOS) 이미지에 대한 사용 애널리틱스를 제공해요. 여기에는 원하는 시간 범위에 대한 이미지·확장 프로그램 사용 메트릭에 대한 셀프 서비스 접근이 포함돼요. 태그별 또는 digest별 이미지 풀 수, 지리적 위치, 클라우드 제공자, 클라이언트 등을 볼 수 있어요.
- DVP 프로그램: 계층별 보고서와 보고서 구성을 포함한 Docker Verified Publisher 조직의 사용 애널리틱스.
- DSOS & Legacy DVP 프로그램: Docker-Sponsored Open Source 게시자와, deprecated된 Legacy DVP 프로그램의 기존 고객을 위한 사용 애널리틱스. Legacy DVP 프로그램은 아직 DVP Core로 갱신하지 않은 기존 고객에게 적용돼요. DVP Legacy 프로그램은 deprecated이며 퇴역할 예정이에요. 자세한 내용은 Docker 영업 담당자나 Docker에 문의해요.
DVP 프로그램
조직의 모든 구성원이 애널리틱스 데이터에 접근할 수 있어요. 구성원은 Docker Hub 웹 인터페이스에서 애널리틱스 데이터에 접근할 수 있어요.
사용 가능한 보고서
조직의 DVP 구독 등급에 따라 다음 보고서를 CSV 파일로 다운로드할 수 있어요:
- Starter 계층: Summary
- Growth 계층: Summary, Trends, Domain-level reports, Benchmark
Domain-level reports와 Benchmark 보고서는 각각 소비 도메인(consuming domains)에 대한 다른 데이터 슬라이스를 제공해요. Domain-level reports는 해당 도메인이 내 이미지를 어떻게 사용하는지, 그리고 내 이미지와 함께 어떤 다른 이미지를 사용하는지 보여줘요. Benchmark는 해당 도메인이 단일 저장소처럼 벤치마킹하도록 구성한 특정 이미지를 어떻게 사용하는지 보여줘요.
조직이 DVP 애널리틱스로 프로비저닝된 후 첫 보고서가 나오기까지 최대 1주일이 걸려요.
Summary 보고서
Summary 보고서는 네임스페이스와 저장소별로 구성된 모든 Docker Hub 콘텐츠에 걸쳐 집계된 상위 수준 사용 메트릭을 제공해요. 이 보고서는 이미지 포트폴리오 성과의 포괄적인 개요를 제공해서 어느 저장소, 태그, 특정 이미지 버전이 사용자에게 가장 인기 있는지 이해하는 데 도움을 줘요. 이 보고서로 다음과 같은 질문에 답할 수 있어요:
- 어떤 저장소가 가장 많이 사용되고 있나요?
- 다양한 이미지 태그는 채택 측면에서 어떻게 비교되나요?
- 포트폴리오 전체에서 실제 다운로드 대 버전 확인 비율은 얼마인가요?
- 가장 자주 풀되는 특정 이미지 digest는 무엇인가요?
- 전체 이미지 모음의 전체 사용량은 시간에 따라 어떻게 변했나요?
보고서에 접근하려면:
- Docker Hub 에 로그인해요.
- 상단 탐색에서 My Hub 를 선택해요.
- 왼쪽 탐색에서 조직을 선택해요.
- 왼쪽 탐색에서 Analytics > Overview 를 선택해요.
- 다음 중 하나로 보고서를 다운로드해요:
- Download Weekly Summary 선택
- Download Monthly Summary 선택
- Summary reports for the year 드롭다운을 펼치고 원하는 주·월의 Download report 선택
Summary 보고서는 다음 데이터 포인트를 포함하는 CSV 파일이에요:
| 필드 | 설명 |
|---|---|
| DATE_GRANULARITY | 주 또는 월 데이터 입도. 데이터가 주·월 중 어느 단위로 집계되었는지 나타냄 |
| DATE_REFERENCE | 주 또는 월의 시작 날짜. YYYY-MM-DD 형식 (예: 2025-09-29) |
| PUBLISHER_NAME | 저장소를 소유한 Docker 조직 이름 (예: demonstrationorg) |
| LEVEL | 데이터 집계 수준 — repository(전체 저장소 요약), tag(특정 태그 요약), digest(특정 digest 요약) 중 하나 |
| REFERENCE | 요약되는 특정 참조 — 수준에 따라 저장소 이름, 태그 이름, digest 해시 |
| DATA_DOWNLOADS | 실제 이미지 다운로드 수 |
| VERSION_CHECKS | 수행된 버전 확인 수 (전체 이미지를 다운로드하지 않고 업데이트를 확인하는 HEAD 요청) |
| EVENT_COUNT | 데이터 다운로드와 버전 확인의 합으로 계산된 전체 이벤트 수 |
Trends 보고서
Trends 보고서는 컨테이너 이미지의 채택이 시간에 따라 어떻게 진화하는지 이해하는 데 도움을 줘요. 저장소와 태그에 걸친 풀 활동에 대한 가시성을 제공해 채택 패턴, 버전 마이그레이션 추세, 사용 환경(예: 로컬 개발, CI/CD, 프로덕션)을 식별할 수 있게 해줘요. 이 보고서로 다음과 같은 질문에 답할 수 있어요:
- 어떤 버전이 견인력을 얻거나 잃고 있나요?
- 새 릴리스가 채택되고 있나요?
- 클라우드 제공자별로 사용량이 어떻게 다르나요?
보고서에 접근하려면:
- Docker Hub 에 로그인해요.
- 상단 탐색에서 My Hub 를 선택해요.
- 왼쪽 탐색에서 조직을 선택해요.
- 왼쪽 탐색에서 Analytics > Trends 를 선택해요.
- DATA BY WEEK 또는 DATA BY MONTH 를 선택해 데이터 입도를 정해요.
- 원하는 주·월의 Download report 를 선택해요.
Trends 보고서는 다음 데이터 포인트를 포함하는 CSV 파일이에요:
| 필드 | 설명 |
|---|---|
| DATE_GRANULARITY | 주 또는 월 데이터 입도 |
| DATE_REFERENCE | 주 또는 월의 시작 날짜 |
| PUBLISHER_NAME | 저장소를 소유한 조직 이름 |
| IMAGE_REPOSITORY | 이미지 저장소의 전체 이름 (예: demonstrationorg/scout-demo) |
| NAMESPACE | 저장소를 소유한 Docker 조직 또는 네임스페이스 |
| IP_COUNTRY | 풀 요청이 시작된 국가 코드 (ISO 3166-1 alpha-2) (예: US, CA) |
| CLOUD_SERVICE_PROVIDER | 풀 요청에 사용된 클라우드 서비스 제공자 (예: gcp, aws, azure) 또는 비클라우드 제공자라면 no csp |
| USER_AGENT | 이미지를 풀하는 데 사용된 클라이언트 애플리케이션·도구 (예: docker, docker-scout, node-fetch, regclient) |
| TAG | 풀된 특정 이미지 태그, 특정 태그가 사용되지 않았다면 \N |
| DATA_DOWNLOADS | 지정된 조건에 대한 데이터 다운로드 수 |
| VERSION_CHECKS | 전체 이미지를 다운로드하지 않고 수행된 버전 확인(HEAD 요청) 수 |
| PULLS | 풀 요청 총 수 (데이터 다운로드 + 버전 확인) |
| UNIQUE_AUTHENTICATED_USERS | 풀을 수행한 고유 인증 사용자 수 |
| UNIQUE_UNAUTHENTICATED_USERS | 풀을 수행한 고유 비인증 사용자 수 |
Domain-level reports
Domain-level reports는 특정 소비 도메인이 Docker Verified Publisher(DVP) 이미지를 단독으로 또는 다른 컨테이너 이미지와 함께 어떻게 사용하는지에 대한 상세 인사이트를 제공해요. 이 보고서는 고객 기반과 잠재 고객에 걸친 사용 패턴, 배포 환경, 채택 추세, 기술 스택 조합을 이해하는 데 도움을 줘요. 이 보고서로 다음과 같은 질문에 답할 수 있어요:
- 특정 소비 도메인이 다양한 환경에서 내 이미지를 어떻게 사용하고 있나요?
- 로컬 개발, CI/CD, 프로덕션에서 어떤 배포 패턴이 보이나요?
- 어떤 소비 도메인이 내 이미지의 헤비 유저인가요?
- 소비 도메인별로 지리와 클라우드 제공자에 따라 사용량이 어떻게 다른가요?
- 어떤 소비 도메인이 내 이미지와 함께 특정 보완 기술을 사용하고 있나요?
- 목표 시장의 엔터프라이즈 고객이 어떤 기술 스택을 채택하고 있나요?
- 어떤 조직이 파트너십 논의의 좋은 후보가 될까요?
- 이미 관련 기술을 사용 중인 잠재 고객을 어떻게 식별할 수 있나요?
Technographic 보고서
Technographic 보고서는 어떤 특정 소비 도메인이 내 DVP 이미지를 다른 컨테이너 이미지와 함께 사용하는지에 대한 상세 보기를 제공해요. 이 보고서는 기술 스택 조합을 채택하고 있는 실제 조직에 대한 가시성을 제공해 목표 비즈니스 개발과 파트너십 기회를 가능하게 해줘요.
보고서에 접근하려면:
- Docker Hub 에 로그인해요.
- 상단 탐색에서 My Hub 를 선택해요.
- 왼쪽 탐색에서 조직을 선택해요.
- 왼쪽 탐색에서 Analytics > Technographic 를 선택해요.
- DATA BY WEEK 또는 DATA BY MONTH 를 선택해 데이터 입도를 정해요.
- 원하는 주·월의 Download report 를 선택해요.
Technographic 보고서는 다음 데이터 포인트를 포함하는 CSV 파일이에요:
| 필드 | 설명 |
|---|---|
| DATE_GRANULARITY | 주 또는 월 데이터 입도 |
| DATE_REFERENCE | 주 또는 월의 시작 날짜 (YYYY-MM-DD 형식) |
| PUBLISHER_NAME | DVP 저장소를 소유한 조직 이름 |
| DOMAIN | 내 DVP 이미지와 짝을 이룬 이미지를 모두 풀한 소비 도메인 (예: example.com) |
| DVPP_IMAGE | Docker Verified Publisher 이미지 저장소 이름 |
| PAIRED_IMAGE | 이 도메인이 내 DVP 이미지와 함께 사용한 다른 이미지 저장소 |
각 행은 지정된 기간 동안 함께 사용된 소비 도메인, 내 DVP 이미지, 다른 이미지의 고유 조합을 나타내요.
참고: 개인 정보 보호와 데이터 품질을 위해 이 보고서는 개인 이메일 도메인, 일회용 이메일 서비스, 대학 도메인을 제외해요. 분석에는 비즈니스·조직 도메인만 포함돼요.
Consuming domains 보고서
Consuming domains 보고서는 특정 소비 도메인이 내 Docker Verified Publisher(DVP) 이미지를 어떻게 사용하는지에 대한 상세 인사이트를 제공해요. 이 보고서는 고객 기반과 잠재 고객에 걸친 사용 패턴, 배포 환경, 채택 추세를 이해하는 데 도움을 줘요.
보고서에 접근하려면:
- Docker Hub 에 로그인해요.
- 상단 탐색에서 My Hub 를 선택해요.
- 왼쪽 탐색에서 조직을 선택해요.
- 왼쪽 탐색에서 Analytics > Consuming Domains 를 선택해요.
- DATA BY WEEK 또는 DATA BY MONTH 를 선택해 데이터 입도를 정해요.
- 원하는 주·월의 Download report 를 선택해요.
Consuming domains 보고서는 다음 데이터 포인트를 포함하는 CSV 파일이에요:
| 필드 | 설명 |
|---|---|
| DATE_GRANULARITY | 주 또는 월 데이터 입도 |
| DATE_REFERENCE | 주 또는 월의 시작 날짜 (YYYY-MM-DD 형식) |
| PUBLISHER_NAME | DVP 저장소를 소유한 조직 이름 |
| DOMAIN | 이미지 풀과 연결된 소비 도메인 (예: docker.com) |
| IP_COUNTRY | 풀 요청이 시작된 국가 코드 (ISO 3166-1 alpha-2) |
| CLOUD_SERVICE_PROVIDER | 풀 요청에 사용된 클라우드 서비스 제공자 또는 비클라우드 제공자라면 no csp |
| USER_AGENT | 이미지를 풀하는 데 사용된 클라이언트 애플리케이션·도구 |
| INFERRED_USE_CASE | 사용자 에이전트·클라우드 제공자 분석을 기반으로 추론된 배포 환경. 값은 다음과 같음: Local Dev(로컬 개발 환경, 예: Docker Desktop, 직접 docker 명령), CI/CD(지속적 통합·배포 파이프라인, 예: containerd, 빌드 도구, 레지스트리 미러링), Prod(프로덕션 환경, 예: Kubernetes, 컨테이너 오케스트레이션 플랫폼), Unknown(사용 가능한 데이터로 사용 사례 판단 불가) |
| IMAGE_REPOSITORY | 풀된 특정 DVP 이미지 저장소 |
| DATA_DOWNLOADS | 이 조합에 대한 실제 이미지 레이어 다운로드 수 |
| VERSION_CHECKS | 전체 이미지를 다운로드하지 않고 수행된 버전 확인(HEAD 요청) 수 |
| PULLS | 풀 요청 총 수 (데이터 다운로드 + 버전 확인) |
| UNIQUE_AUTHENTICATED_USERS | 풀을 수행한 이 도메인의 고유 인증 사용자 수 |
참고: 사용 사례 추론은 사용자 에이전트 패턴과 클라우드 서비스 제공자 사용을 분석해 결정돼요. 클라우드 인프라에서 사용되는 로컬 개발 도구는 CI/CD로, 클라우드 인프라에서 사용되는 CI/CD 도구는 프로덕션으로 재분류되어 실제 배포 패턴을 더 잘 반영해요.
Benchmark 보고서
Benchmark 보고서는 소비 도메인이 단일 저장소처럼 벤치마킹하도록 구성한 특정 이미지와 어떻게 상호작용하는지 보여줘요. 보고서는 저장소별로 생성되므로 구성한 각 벤치마크 저장소가 자체 보고서를 만들어요.
보고서에 접근하려면:
- Docker Hub 에 로그인해요.
- 상단 탐색에서 My Hub 를 선택해요.
- 왼쪽 탐색에서 조직을 선택해요.
- 왼쪽 탐색에서 Analytics > Benchmark 를 선택해요.
- DATA BY WEEK 또는 DATA BY MONTH 를 선택해 데이터 입도를 정해요.
- 원하는 주·월의 Download report 를 선택해요.
Benchmark 보고서는 다음 데이터 포인트를 포함하는 CSV 파일이에요:
| 필드 | 설명 |
|---|---|
| DATE_GRANULARITY | 주 또는 월 데이터 입도 |
| DATE_REFERENCE | 주 또는 월의 시작 날짜 (YYYY-MM-DD 형식) |
| PUBLISHER_NAME | DVP 저장소를 소유한 조직 이름 |
| DOMAIN | 풀과 연결된 소비 도메인 |
| IP_COUNTRY | 풀 요청이 시작된 국가 코드 (ISO 3166-1 alpha-2) |
| CLOUD_SERVICE_PROVIDER | 풀 요청에 사용된 클라우드 서비스 제공자 또는 비클라우드 제공자라면 no csp |
| USER_AGENT | 이미지를 풀하는 데 사용된 클라이언트 애플리케이션·도구 |
| INFERRED_USE_CASE | consuming domains 보고서와 같은 규칙을 사용하는 추론된 배포 환경 |
| IMAGE_REPOSITORY | 풀된 벤치마크 구성 이미지 저장소 |
| DATA_DOWNLOADS | 이 조합에 대한 실제 이미지 레이어 다운로드 수 |
| VERSION_CHECKS | 전체 이미지를 다운로드하지 않고 수행된 버전 확인(HEAD 요청) 수 |
| PULLS | 풀 요청 총 수 (데이터 다운로드 + 버전 확인) |
| UNIQUE_AUTHENTICATED_USERS | 이 도메인에서 풀을 수행한 고유 인증 사용자 수 |
벤치마킹할 저장소를 구성하려면 Configure DVP analytics settings 를 참고해요.
DVP 애널리틱스 설정 구성
조직 소유자와 편집자는 Admin Console을 통해 DVP 애널리틱스 설정을 구성해 검증된 게시자 네임스페이스에 대한 소비 도메인과 벤치마크 보고서 할당을 제어할 수 있어요.
- Docker Home에 로그인하고 조직을 선택해요.
- Admin Console > Verified Publisher 를 선택해요.
- 설정을 구성해요:
- Consuming domains: 보고 목적으로 추적할 소비 도메인 수를 설정해요. 이 설정은 Domain-level reports 에 나타나는 도메인 수를 결정해요. 이 숫자는 DVP 구독에 포함된 최대값까지만 설정할 수 있어요.
- Benchmark report allocations: 조직에 벤치마크 보고서가 활성화되어 있다면 나열된 각 네임스페이스에 대해 벤치마크 보고서에 포함할 소비 도메인 수를 입력해요.
- 변경 사항을 적용하려면 Save 를 선택해요. 보고서 구성 변경은 다음 보고 주기(다음 주간 또는 월간 보고서)부터 적용돼요.
DSOS & Legacy DVP 프로그램
중요: Legacy DVP 프로그램은 아직 DVP Core로 갱신하지 않은 기존 고객에게 적용돼요. DVP Legacy 프로그램은 deprecated이며 퇴역할 예정이에요. 자세한 내용은 Docker 영업 담당자나 Docker에 문의해요.
이미지 애널리틱스 데이터 보기
저장소의 애널리틱스 데이터는 다음 URL의 Insights and analytics 대시보드에서 찾을 수 있어요: https://hub.docker.com/orgs/{namespace}/insights/images. 대시보드에는 사용 데이터의 시각화와 데이터를 CSV 파일로 다운로드할 수 있는 표가 포함돼요.
차트에서 데이터를 보려면:
- 데이터 입도 선택: weekly 또는 monthly
- 시간 간격 선택: 3, 6, 또는 12개월
- 목록에서 저장소 하나 이상 선택
팁: 차트 위에 커서를 올리면 툴팁이 표시되어 정확한 시점 데이터를 보여줘요.
애널리틱스 데이터 공유
차트 상단의 Share 아이콘을 사용해 시각화를 다른 사람과 공유할 수 있어요. 이는 조직 내 다른 사람들과 통계를 공유하는 편리한 방법이에요. 아이콘을 선택하면 클립보드에 복사되는 링크가 생성돼요. 링크는 만든 디스플레이 선택을 보존해요. 누군가 링크를 따라가면 Insights and analytics 페이지가 열리고, 링크를 만들 때 설정했던 것과 같은 구성의 차트가 표시돼요.
확장 프로그램 애널리틱스 데이터
Extension 마켓플레이스에 Docker Extensions를 게시했다면 확장 프로그램 사용에 대한 애널리틱스도 CSV 파일로 얻을 수 있어요. 확장 프로그램 CSV 보고서는 다음 URL의 Insights and analytics 대시보드에서 다운로드할 수 있어요: https://hub.docker.com/orgs/{namespace}/insights/extensions. Docker 네임스페이스에 마켓플레이스에서 알려진 확장 프로그램이 있다면 사용자 확장 프로그램용 CSV 파일을 나열하는 Extensions 탭이 보일 거예요.
애널리틱스 데이터 내보내기
애널리틱스 데이터는 웹 대시보드 또는 DVP Data API 를 사용해 내보낼 수 있어요. 조직의 모든 구성원이 애널리틱스 데이터에 접근할 수 있어요. 데이터는 주간(월요일~일요일) 또는 월간 형식의 다운로드 가능한 CSV 파일로 제공돼요. 월간 데이터는 다음 달 첫날부터 사용 가능해요. 이 데이터를 자체 시스템으로 가져오거나 스프레드시트로 수동 분석할 수 있어요.
데이터 내보내기
Docker Hub 웹사이트를 사용해 조직 이미지의 사용 데이터를 내보내려면:
- Docker Hub 에 로그인하고 My Hub 를 선택해요.
- 조직을 선택하고 Analytics 를 선택해요.
- 애널리틱스 데이터를 내보낼 시간 범위를 설정해요. 오른쪽에 요약·원시 데이터용 다운로드 가능한 CSV 파일이 나타나요.
API로 데이터 내보내기
HTTP API 엔드포인트는 https://hub.docker.com/api/publisher/analytics/v1 에 있어요. API로 데이터를 내보내는 방법은 DVP Data API 문서 에서 배워봐요.
데이터 포인트
데이터를 원시(raw) 또는 요약(summary) 형식으로 내보내요. 각 형식은 다른 데이터 포인트와 다른 구조를 포함해요. 다음 섹션은 각 형식에 대해 사용 가능한 데이터 포인트를 설명해요. Date added 열은 필드가 처음 도입된 시기를 보여줘요.
이미지 풀 원시 데이터 — 원시 데이터 형식은 다음 데이터 포인트를 포함해요. CSV 파일의 각 행은 하나의 이미지 풀을 나타내요:
| 데이터 포인트 | 설명 | 추가 날짜 |
|---|---|---|
| Action | 요청 유형, Action classification rules 참고. pull_by_tag, pull_by_digest, version_check 중 하나 | 2022년 1월 1일 |
| Action day | 타임스탬프의 날짜 부분: YYYY-MM-DD | 2022년 1월 1일 |
| Country | 요청 원산지 국가 | 2022년 1월 1일 |
| Digest | 이미지 digest | 2022년 1월 1일 |
| HTTP method | 요청에 사용된 HTTP 메서드, 자세한 내용은 registry API 문서 참고 | 2022년 1월 1일 |
| Host | 이벤트에 사용된 클라우드 서비스 제공자 | 2022년 1월 1일 |
| Namespace | Docker 조직 (이미지 네임스페이스) | 2022년 1월 1일 |
| Reference | 요청에 사용된 이미지 digest 또는 태그 | 2022년 1월 1일 |
| Repository | Docker 저장소 (이미지 이름) | 2022년 1월 1일 |
| Tag (가능할 때 포함) | 요청이 태그를 참조한 경우에만 사용 가능한 태그 이름 | 2022년 1월 1일 |
| Timestamp | 요청 날짜와 시간: YYYY-MM-DD 00:00:00 | 2022년 1월 1일 |
| Type | 이벤트가 발생한 산업. business, isp, hosting, education, null 중 하나 | 2022년 1월 1일 |
| User agent tool | 사용자가 이미지를 풀하는 데 사용한 애플리케이션 (예: docker, containerd) | 2022년 1월 1일 |
| User agent version | 이미지를 풀하는 데 사용된 애플리케이션 버전 | 2022년 1월 1일 |
| Domain | 요청 원산지 도메인, Privacy 참고 | 2022년 10월 11일 |
| Owner | 저장소를 소유한 조직 이름 | 2022년 12월 19일 |
이미지 풀 요약 데이터 — 두 수준의 요약 데이터를 사용할 수 있어요:
- 저장소 수준: 모든 네임스페이스와 저장소의 요약
- 태그 또는 digest 수준: 모든 네임스페이스, 저장소, 참조(태그 또는 digest)의 요약
요약 데이터 형식은 선택한 시간 범위에 대해 다음 데이터 포인트를 포함해요:
| 데이터 포인트 | 설명 | 추가 날짜 |
|---|---|---|
| Unique IP address | 고유 IP 주소 수, Privacy 참고 | 2022년 1월 1일 |
| Pull by tag | digest 또는 tag에 의한 GET 요청 | 2022년 1월 1일 |
| Pull by digest | digest에 의한 GET 또는 HEAD 요청, 또는 digest에 의한 HEAD | 2022년 1월 1일 |
| Version check | GET이 뒤따르지 않는 tag에 의한 HEAD | 2022년 1월 1일 |
| Owner | 저장소를 소유한 조직 이름 | 2022년 12월 19일 |
이미지 풀 동작 분류 규칙
동작(action)은 docker pull 과 관련된 여러 요청 이벤트를 나타내요. 풀은 사용자 행동과 의도를 이해하는 데 데이터를 더 의미 있게 만들기 위해 범주별로 그룹화돼요. 범주는 다음과 같아요:
- Version check
- Pull by tag
- Pull by digest
자동화된 시스템은 내 이미지의 새 버전을 자주 확인해요. CI에서 "버전 확인"과 사용자의 실제 이미지 풀을 구분할 수 있다면 사용자 행동에 대한 더 많은 통찰을 얻을 수 있어요. 다음 표는 풀 뒤의 의도를 결정하는 데 적용되는 규칙을 설명해요. 이 규칙에 대한 피드백이나 질문은 Google Form 을 작성해요.
| 시작 이벤트 | 참조 | 뒤이은 이벤트 | 결과 동작 | 사용 사례 |
|---|---|---|---|---|
| HEAD | tag | N/A | Version check | 사용자가 로컬 머신에 모든 레이어를 이미 보유 |
| GET | tag | N/A | Pull by tag | 사용자가 모든 이미지 레이어를 로컬에 이미 보유 및/또는 이미지가 단일 아키텍처 |
| GET | tag | 다른 digest로 GET | Pull by tag | 이미지가 멀티 아키텍처. 두 번째 digest GET은 첫 번째와 달라야 함 |
| HEAD | tag | 같은 digest로 GET | Pull by tag | 이미지가 멀티 아키텍처지만 일부 또는 모든 이미지 레이어가 로컬 머신에 이미 존재 |
| HEAD | tag | 같은 digest로 GET, 그다음 다른 digest로 두 번째 GET | Pull by tag | 이미지가 멀티 아키텍처 |
| GET | digest | N/A | Pull by digest | 사용자가 모든 이미지 레이어를 로컬에 이미 보유 및/또는 이미지가 단일 아키텍처 |
| HEAD | digest | N/A | Pull by digest | 사용자가 모든 이미지 레이어를 로컬에 이미 보유 |
| GET | digest | 다른 digest로 GET | Pull by digest | 이미지가 멀티 아키텍처. 두 번째 digest GET은 첫 번째와 달라야 함 |
| HEAD | digest | 같은 digest로 GET | Pull by digest | 이미지가 단일 아키텍처 및/또는 이미지의 일부가 로컬 머신에 이미 존재 |
| HEAD | digest | 같은 digest로 GET, 그다음 다른 digest로 두 번째 GET | Pull by digest | 이미지가 멀티 아키텍처 |
확장 프로그램 요약 데이터
두 수준의 확장 프로그램 요약 데이터를 사용할 수 있어요:
- Core 요약: 기본 확장 사용 정보 — 확장 설치 수, 제거 수, 총 설치 수.
- Premium 요약: 고급 확장 사용 정보 — 고유 사용자별 설치·제거, 고유 사용자별 확장 열기.
core-summary-data 파일은 선택한 시간 범위에 대해 다음 데이터 포인트를 포함해요:
| 데이터 포인트 | 설명 | 추가 날짜 |
|---|---|---|
| Installs | 확장 프로그램 설치 수 | 2024년 2월 1일 |
| TotalInstalls | 확장 프로그램 전체 기간 설치 수 | 2024년 2월 1일 |
| Uninstalls | 확장 프로그램 제거 수 | 2024년 2월 1일 |
| TotalUninstalls | 확장 프로그램 전체 기간 제거 수 | 2024년 2월 1일 |
| Updates | 확장 프로그램 업데이트 수 | 2024년 2월 1일 |
Premium 요약 데이터 파일은 다음 데이터 포인트를 포함해요:
| 데이터 포인트 | 설명 | 추가 날짜 |
|---|---|---|
| Installs | 확장 프로그램 설치 수 | 2024년 2월 1일 |
| UniqueInstalls | 확장 프로그램을 설치한 고유 사용자 수 | 2024년 2월 1일 |
| Uninstalls | 확장 프로그램 제거 수 | 2024년 2월 1일 |
| UniqueUninstalls | 확장 프로그램을 제거한 고유 사용자 수 | 2024년 2월 1일 |
| Usage | 확장 프로그램 탭 열기 수 | 2024년 2월 1일 |
| UniqueUsers | 확장 프로그램 탭을 연 고유 사용자 수 | 2024년 2월 1일 |
시간에 따른 데이터 변화
인사이트·애널리틱스 서비스는 게시자에게 가져다주는 가치를 높이기 위해 지속적으로 개선돼요. 일부 변경에는 새 데이터 포인트 추가나 기존 데이터 개선이 포함될 수 있어요. 데이터셋의 변경(필드 추가·제거 등)은 일반적으로 필드가 처음 도입된 날짜부터 이후에만 적용돼요. 특정 데이터 포인트가 언제부터 사용 가능한지는 Data points 섹션의 표를 참고해요.
개인 정보 보호
이 섹션은 Docker Hub의 콘텐츠 소비자가 완전히 익명으로 유지되도록 보장하는 개인 정보 보호 조치에 대한 정보를 포함해요.
중요: Docker는 애널리틱스 데이터의 일부로 개인 식별 정보(PII)를 절대 공유하지 않아요.
- 이미지 풀 요약 데이터셋에는 고유 IP 주소 수가 포함돼요. 이 데이터 포인트는 이미지를 요청한 고유 IP 주소의 수만 포함해요. 개별 IP 주소는 절대 공유되지 않아요.
- 이미지 풀 원시 데이터셋에는 사용자 IP 도메인이 데이터 포인트로 포함돼요. 이는 이미지를 풀하는 데 사용된 IP 주소와 연결된 도메인 이름이에요. IP 유형이 business 라면 도메인은 해당 IP 주소와 연결된 회사·조직을 나타내요 (예: docker.com). business 가 아닌 다른 IP 유형이라면 도메인은 요청을 하는 데 사용된 인터넷 서비스 제공자 또는 호스팅 제공자를 나타내요. 평균적으로 전체 풀의 약 30%만 business IP 유형으로 분류돼요 (게시자와 이미지에 따라 다름).