Analyses et analytiques

Table des matières

Analyses et analytiques fournit des analyses d'utilisation pour les images Docker Verified Publisher (DVP) et Docker-Sponsored Open Source (DSOS) sur Docker Hub. Cela inclut un accès en libre-service aux métriques d'utilisation d'images et d'extensions pour une période désirée. Vous pouvez également afficher le nombre de téléchargements d'images par étiquette ou par digest, et obtenir des ventilations par géolocalisation, fournisseur cloud, client, et plus.

Tip

Dirigez-vous vers les pages Programme Docker Verified Publisher ou Docker-Sponsored Open Source pour en apprendre plus sur les programmes.

Voir les données analytiques de l'image

Vous pouvez trouver les données analytiques pour vos dépôts sur le tableau de bord Analyses et analytiques à l'URL suivante : https://hub.docker.com/orgs/{namespace}/insights/images. Le tableau de bord contient une visualisation des données d'utilisation et un tableau où vous pouvez télécharger les données sous forme de fichiers CSV.

Pour voir les données dans le graphique :

Sélectionnez la granularité des données : hebdomadaire ou mensuelle
Sélectionnez l'intervalle de temps : 3, 6, ou 12 mois
Sélectionnez un ou plusieurs dépôts dans la liste

Visualisation du graphique analyses et analytiques

Tip

Survoler votre curseur sur le graphique affiche une info-bulle, montrant les données précises pour des points dans le temps.

Partager les données analytiques

Vous pouvez partager la visualisation avec d'autres en utilisant l'icône Partager au-dessus du graphique. C'est un moyen pratique de partager les statistiques avec d'autres dans votre organisation.

Sélectionner l'icône génère un lien qui est copié dans votre presse-papier. Le lien préserve les sélections d'affichage que vous avez faites. Quand quelqu'un suit le lien, la page Analyses et analytiques s'ouvre et affiche le graphique avec la même configuration que vous aviez définie lors de la création du lien.

Données analytiques d'extension

Si vous avez publié des Extensions Docker dans le marché des Extensions, vous pouvez également obtenir des analyses sur l'utilisation de votre extension, disponibles sous forme de fichiers CSV. Vous pouvez télécharger les rapports CSV d'extension depuis le tableau de bord Analyses et analytiques à l'URL suivante : https://hub.docker.com/orgs/{namespace}/insights/extensions. Si votre espace de noms Docker contient des extensions connues dans le marché, vous verrez un onglet Extensions listant les fichiers CSV pour votre/vos extension(s).

Exporter les données analytiques

Vous pouvez exporter les données analytiques soit depuis le tableau de bord web, soit en utilisant l' API DVP Data. Tous les membres d'une organisation ont accès aux données analytiques.

Les données sont disponibles sous forme de fichier CSV téléchargeable, dans un format hebdomadaire (lundi à dimanche) ou mensuel. Les données mensuelles sont disponibles à partir du premier jour du mois calendaire suivant. Vous pouvez importer ces données dans vos propres systèmes, ou vous pouvez les analyser manuellement comme une feuille de calcul.

Exporter les données

Exportez les données d'utilisation pour les images de votre organisation en utilisant le site web Docker Hub en suivant ces étapes :

Connectez-vous à Docker Hub et sélectionnez Mon Hub.
Choisissez votre organisation et sélectionnez Analytiques.
Définissez la période pour laquelle vous voulez exporter les données analytiques.

Les fichiers CSV téléchargeables pour les données résumées et brutes apparaissent sur le côté droit.

Exporter les données en utilisant l'API

Les points de terminaison API HTTP sont disponibles à : https://hub.docker.com/api/publisher/analytics/v1. Apprenez comment exporter les données en utilisant l'API dans la documentation de l'API DVP Data.

Points de données

Exportez les données soit en format brut soit en format résumé. Chaque format contient différents points de données et avec une structure différente.

Les sections suivantes décrivent les points de données disponibles pour chaque format. La colonne Date ajoutée montre quand le champ a été introduit pour la première fois.

Données brutes de téléchargements d'images

Le format de données brutes contient les points de données suivants. Chaque ligne dans le fichier CSV représente un téléchargement d'image.

Point de données	Description	Date ajoutée
Action	Type de requête, voir Règles de classification d'action. Un de `pull_by_tag`, `pull_by_digest`, `version_check`.	1er janvier 2022
Jour d'action	La partie date de l'horodatage : `YYYY-MM-DD`.	1er janvier 2022
Pays	Pays d'origine de la requête.	1er janvier 2022
Digest	Digest de l'image.	1er janvier 2022
Méthode HTTP	Méthode HTTP utilisée dans la requête, voir documentation API registre pour les détails.	1er janvier 2022
Hôte	Le fournisseur de service cloud utilisé dans un événement.	1er janvier 2022
Espace de noms	Organisation Docker (espace de noms d'image).	1er janvier 2022
Référence	Digest d'image ou étiquette utilisée dans la requête.	1er janvier 2022
Dépôt	Dépôt Docker (nom d'image).	1er janvier 2022
Étiquette (incluse quand disponible)	Nom d'étiquette qui n'est disponible que si la requête faisait référence à une étiquette.	1er janvier 2022
Horodatage	Date et heure de la requête : `YYYY-MM-DD 00:00:00`.	1er janvier 2022
Type	L'industrie d'où provient l'événement. Un de `business`, `isp`, `hosting`, `education`, `null`.	1er janvier 2022
Outil agent utilisateur	L'application qu'un utilisateur a utilisée pour télécharger une image (par exemple, `docker` ou `containerd`).	1er janvier 2022
Version agent utilisateur	La version de l'application utilisée pour télécharger une image.	1er janvier 2022
Domaine	Domaine d'origine de la requête, voir Confidentialité.	11 octobre 2022
Propriétaire	Le nom de l'organisation qui possède le dépôt.	19 décembre 2022

Données résumées de téléchargements d'images

Il y a deux niveaux de données résumées disponibles :

Niveau dépôt, un résumé de chaque espace de noms et dépôt
Niveau étiquette ou digest, un résumé de chaque espace de noms, dépôt, et référence (étiquette ou digest)

Les formats de données résumées contiennent les points de données suivants pour la période sélectionnée :

Point de données	Description	Date ajoutée
Adresse IP unique	Nombre d'adresses IP uniques, voir Confidentialité.	1er janvier 2022
Téléchargement par étiquette	Requête GET, par digest ou par étiquette.	1er janvier 2022
Téléchargement par digest	Requête GET ou HEAD par digest, ou HEAD par digest.	1er janvier 2022
Vérification de version	HEAD par étiquette, non suivi par un GET	1er janvier 2022
Propriétaire	Le nom de l'organisation qui possède le dépôt.	19 décembre 2022

Règles de classification d'action de téléchargements d'images

Une action représente les multiples événements de requête associés à un docker pull. Les téléchargements sont groupés par catégorie pour rendre les données plus significatives pour comprendre le comportement et l'intention des utilisateurs. Les catégories sont :

Vérification de version
Téléchargement par étiquette
Téléchargement par digest

Les systèmes automatisés vérifient fréquemment les nouvelles versions de vos images. Être capable de distinguer entre les "vérifications de version" en CI versus les téléchargements d'images réels par un utilisateur vous accorde plus d'aperçu du comportement de vos utilisateurs.

Le tableau suivant décrit les règles appliquées pour déterminer l'intention derrière les téléchargements. Pour fournir des commentaires ou poser des questions sur ces règles, remplissez le formulaire Google.

Événement de départ	Référence	Suivi par	Action résultante	Cas d'usage(s)	Notes
HEAD	étiquette	N/A	Vérification de version	L'utilisateur a déjà toutes les couches existantes sur la machine locale	Ceci est similaire au cas d'usage d'un téléchargement par étiquette quand l'utilisateur a déjà toutes les couches d'images existantes localement, cependant, cela différencie l'intention utilisateur et classe en conséquence.
GET	étiquette	N/A	Téléchargement par étiquette	L'utilisateur a déjà toutes les couches existantes sur la machine locale et/ou l'image est mono-architecture
GET	étiquette	Get par digest différent	Téléchargement par étiquette	L'image est multi-architecture	Le second GET par digest doit être différent du premier.
HEAD	étiquette	GET par même digest	Téléchargement par étiquette	L'image est multi-architecture mais certaines ou toutes les couches d'images existent déjà sur la machine locale	Le HEAD par étiquette envoie le digest le plus actuel, le GET suivant doit être par ce même digest. Il peut y avoir un GET supplémentaire, si l'image est multi-architecture (voir la ligne suivante dans ce tableau). Si l'utilisateur ne veut pas le digest le plus récent, alors l'utilisateur fait HEAD par digest.
HEAD	étiquette	GET par le même digest, puis un second GET par un digest différent	Téléchargement par étiquette	L'image est multi-architecture	Le HEAD par étiquette envoie le digest le plus récent, le GET suivant doit être par ce même digest. Puisque l'image est multi-architecture, il y a un second GET par un digest différent. Si l'utilisateur ne veut pas le digest le plus récent, alors l'utilisateur fait HEAD par digest.
HEAD	étiquette	GET par même digest, puis un second GET par digest différent	Téléchargement par étiquette	L'image est multi-architecture	Le HEAD par étiquette envoie le digest le plus actuel, le GET suivant doit être par ce même digest. Puisque l'image est multi-architecture, il y a un second GET par un digest différent. Si l'utilisateur ne veut pas le digest le plus récent, alors l'utilisateur fait HEAD par digest.
GET	digest	N/A	Téléchargement par digest	L'utilisateur a déjà toutes les couches existantes sur la machine locale et/ou l'image est mono-architecture
HEAD	digest	N/A	Téléchargement par digest	L'utilisateur a déjà toutes les couches existantes sur sa machine locale
GET	digest	GET par digest différent	Téléchargement par digest	L'image est multi-architecture	Le second GET par digest doit être différent du premier.
HEAD	digest	GET par même digest	Téléchargement par digest	L'image est mono-architecture et/ou l'image est multi-architecture mais une partie de l'image existe déjà sur la machine locale
HEAD	digest	GET par même digest, puis un second GET par digest différent	Téléchargement par Digest	L'image est multi-architecture

Données résumées d'Extension

Il y a deux niveaux de données résumées d'extension disponibles :

Résumé principal, avec des informations d'utilisation d'extension de base : nombre d'installations d'extension, désinstallations, et total d'installations de tous les temps

Le fichier de données-résumé-principal contient les points de données suivants pour la période sélectionnée :

Point de données	Description	Date ajoutée
Installations	Nombre d'installations pour l'extension	1er fév 2024
TotalInstallations	Nombre d'installations pour l'extension de tous les temps	1er fév 2024
Désinstallations	Nombre de désinstallations pour l'extension	1er fév 2024
TotalDésinstallations	Nombre de désinstallations pour l'extension de tous les temps	1er fév 2024
Mises à jour	Nombre de mises à jour pour l'extension	1er fév 2024

Résumé premium, avec des informations d'utilisation d'extension avancées : installations, désinstallations par utilisateurs uniques, ouverture d'extension par utilisateurs uniques.

Le fichier de données-résumé-principal contient les points de données suivants pour la période sélectionnée :

Point de données	Description	Date ajoutée
Installations	Nombre d'installations pour l'extension	1er fév 2024
InstallationsUniques	Nombre d'utilisateurs uniques installant l'extension	1er fév 2024
Désinstallations	Nombre de désinstallations pour l'extension	1er fév 2024
DésinstallationsUniques	Nombre d'utilisateurs uniques désinstallant l'extension	1er fév 2024
Utilisation	Nombre d'ouvertures de l'onglet extension	1er fév 2024
UtilisateursUniques	Nombre d'utilisateurs uniques ouvrant l'onglet extension	1er fév 2024

Changements dans les données au fil du temps

Le service d'analyses et analytiques est continuellement amélioré pour augmenter la valeur qu'il apporte aux éditeurs. Certains changements peuvent inclure l'ajout de nouveaux points de données, ou l'amélioration des données existantes pour les rendre plus utiles.

Les changements dans le jeu de données, comme les champs ajoutés ou supprimés, s'appliquent généralement seulement à partir de la date où le champ a été introduit pour la première fois, et en avançant.

Référez-vous aux tableaux dans la section Points de données pour voir à partir de quelle date un point de données donné est disponible.

Confidentialité

Cette section contient des informations sur les mesures de protection de la confidentialité qui assurent que les consommateurs de contenu sur Docker Hub restent complètement anonymes.

Important

Docker ne partage jamais d'Informations Personnellement Identifiables (PII) dans le cadre des données analytiques.

Le jeu de données résumées de téléchargements d'images inclut le compte d'adresses IP uniques. Ce point de données inclut seulement le nombre d'adresses IP uniques distinctes qui demandent une image. Les adresses IP individuelles ne sont jamais partagées.

Le jeu de données brutes de téléchargements d'images inclut les domaines IP utilisateur comme point de données. C'est le nom de domaine associé à l'adresse IP utilisée pour télécharger une image. Si le type IP est business, le domaine représente la compagnie ou organisation associée avec cette adresse IP (par exemple, docker.com). Pour tout autre type IP qui n'est pas business, le domaine représente le fournisseur de services internet ou fournisseur d'hébergement utilisé pour faire la requête. En moyenne, seulement environ 30% de tous les téléchargements se classent comme type IP business (cela varie entre éditeurs et images).