- Suivre l’utilisation des crédits dans votre espace de travail et par utilisateur individuel.
- Surveiller le pool de crédits de votre espace de travail et les limites de crédits par membre.
- Surveiller l’activité des utilisateurs et identifier les comptes inactifs.
- Auditer les paramètres de sécurité des apps.
- Analyser l’engagement avec les vues, les utilisateurs actifs et les tendances d’utilisation.
Espaces de travail
Un espace de travail est un environnement partagé où les équipes collaborent sur des apps. L’API Monitoring fournit aux owners et admins d’espace de travail des données agrégées sur les utilisateurs et les apps d’un espace de travail spécifique.ID d’espace de travail
La plupart des endpoints nécessitent unworkspace_id dans le chemin de l’URL, et vous devez avoir le rôle admin ou owner dans cet espace de travail pour y accéder.
Pour obtenir votre workspace_id, accédez à la page de gestion de votre espace de travail :
- Cliquez sur votre icône de profil en haut à droite de votre compte.
- Survolez l’espace de travail concerné et cliquez sur Manage.
- L’ID de l’espace de travail est la dernière partie de l’URL de la page de gestion de l’espace de travail.
Pools de crédits et limites par membre
Votre espace de travail partage un seul pool de crédits pour chaque période de réinitialisation des crédits. Le pool suit séparément les crédits de message et d’intégration, et chacun rapporte sa limite, le montant utilisé et le montant restant. La période de réinitialisation correspond à celle indiquée sur votre page de facturation. Pour les abonnements annuels qui se réinitialisent mensuellement, il s’agit de la fenêtre mensuelle. La réponseGet analytics renvoie ces données dans l’objet credit_pool, y compris votre tier, les limites quotidiennes de messages, les crédits bonus, le solde de carte cadeau et les indicateurs de dépassement de limite.
Les espaces de travail peuvent également définir des limites de crédits par membre sur le nombre de crédits de message que chaque membre prélève sur le pool partagé. La limite d’un membre provient soit d’un override individuel, soit d’une valeur par défaut de l’espace de travail. L’objet member_allocations dans la réponse analytics résume ces limites sur votre espace de travail, et l’objet member_allocation sur chaque utilisateur dans Get user rapporte la limite et l’utilisation d’un membre individuel.
Les limites de crédits par membre dépendent du tier de votre espace de travail. Lorsque votre tier ne les prend pas en charge, les membres prélèvent du pool sans limite individuelle, et les champs par membre renvoient
null.Exemples de workflows
Voici quelques façons courantes d’utiliser l’API Monitoring.Comparer l’utilisation mensuelle
1
Obtenir les analytics du mois en cours
Appelez
Get analytics avec la plage de dates
de ce mois pour obtenir la consommation actuelle des crédits et l’activité des utilisateurs.2
Obtenir les analytics du mois précédent
Appelez à nouveau
Get analytics avec
la plage de dates du mois dernier pour comparer les tendances.Analyser l’activité des utilisateurs
1
Lister les utilisateurs
Appelez
List users pour obtenir tous les utilisateurs avec
les données de consommation résumées pour la période de facturation actuelle.2
Obtenir un utilisateur
Appelez
Get user pour obtenir les données de consommation pour
un utilisateur spécifique sur une plage de dates personnalisée.Trouver les membres au-dessus de leur limite de crédits
1
Lister les utilisateurs au-dessus de leur limite
Appelez
List users avec
over_member_limit=true pour renvoyer uniquement les membres qui ont dépassé leur
limite de crédits par membre dans la période actuelle de réinitialisation des crédits.2
Obtenir les détails d'allocation du membre
Appelez
Get user pour un membre spécifique afin de
voir son member_allocation, y compris la limite, la source de la limite
et les crédits restants.Auditer une app
1
Lister les utilisateurs
Appelez
List users pour trouver les utilisateurs de votre
espace de travail.2
Lister les apps utilisateur
Appelez
List user apps pour obtenir les IDs d’apps
d’un utilisateur spécifique.3
Obtenir les analytics de l'app
Appelez
Get app analytics pour obtenir
des métriques détaillées et des indicateurs de gouvernance pour l’app.Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.