Passer au contenu principal

Vue d’ensemble

La console Enterprise (sur console.gnip.com) est disponible pour les clients data Enterprise ayant un accès API Enterprise sous contrat. Si vous n’êtes pas actuellement client data Enterprise mais souhaitez en savoir plus, consultez la page dédiée aux données Enterprise.
Cette page présente le tableau de bord de la console Enterprise de X. Les sections décrites couvrent chaque zone de la console relative aux détails produits, à l’utilisation et à la gestion générale du compte. Si vous avez des questions concernant votre compte, veuillez contacter votre gestionnaire de compte attitré ou consulter notre documentation technique pour les produits Enterprise. Dans le cadre de l’essai Enterprise et du processus d’onboarding avec votre gestionnaire de compte, les clients Enterprise recevront des identifiants pour se connecter à console.gnip.com, l’interface où l’accès aux produits Enterprise peut être consulté et configuré. L’accès initial à la console pour l’administrateur client est mis en place par X dans le cadre de l’onboarding Enterprise, puis les administrateurs peuvent ajouter d’autres utilisateurs. La console Enterprise vous permet de gérer vos produits Enterprise et d’accéder à des informations détaillées les concernant.  La vidéo suivante présente un aperçu des différentes sections du tableau de bord console.gnip.com.  Avertissement : veuillez noter que certaines fonctionnalités présentées dans la vidéo, notamment certains enrichissements de stream et des produits issus de sources de données non X, peuvent ne plus être disponibles.

Onglet Products

Après vous être connecté à votre compte sur console.gnip.com, vous arrivez sur l’onglet Products du tableau de bord. Cette page propose une vue d’ensemble des produits Enterprise actuellement disponibles sur votre compte. Pour les produits utilisant une diffusion en stream, comme PowerTrack ou Decahose, cette page répertorie le nom du produit, le libellé du stream, le nombre de connexions actives en cours, le nombre de règles actuellement actives pour chacun (le cas échéant), ainsi que le nombre brut d’activités (par exemple, des Posts) livrées au cours des 24 dernières heures. Pour les produits avec livraison REST, comme Search API, cette page répertorie le nom du produit, les libellés (également affichés comme « streams »), les activités en cours (par exemple, des Posts) renvoyées via ces endpoints, ainsi que plusieurs décomptes de requêtes par endpoint. Notez que l’Usage API fournit une grande partie de ces data de manière programmatique. Des détails spécifiques par stream sont disponibles en cliquant sur le nom ou sur le bouton des paramètres.

Vue d’ensemble

Cliquer sur l’un des streams dans le tableau de bord principal vous amène à une page d’aperçu de ce stream. Pour les produits de diffusion en continu, cette page comprend les éléments suivants :
  1. Un graphique du volume d’activités qui vous sont livrées via chaque connexion de stream spécifique
  2. Des détails (id de connexion et adresse IP) sur les connexions actuellement actives sur le stream
  3. Un journal des événements récents de connexion, de déconnexion et de mise à jour des règles pour votre stream
Notez que l’échelle du graphique peut être ajustée à l’aide des liens dans le coin supérieur droit. La visibilité des connexions et des déconnexions individuelles peut être activée ou désactivée en cliquant sur l’élément correspondant dans la légende directement sous le graphique.

Connexions

La page Connexions fournit des informations sur les événements de connexion récents de votre stream. Elle indique notamment les heures de début et de fin de chaque connexion (au format 24 h, UTC), la durée de chaque connexion, l’adresse IP du serveur à l’origine de la connexion, un identifiant de connexion unique à des fins de référence, ainsi que l’état actuel de la connexion. L’état correspond à l’événement le plus récent pour la connexion spécifiée — p. ex. « Client connecté » ou une déconnexion, avec le type de déconnexion précisé. Pour plus d’informations sur le débogage des connexions, consultez le guide expliquant les déconnexions.

Aide de l’API

La page Aide de l’API fournit les URL des endpoint de l’API pour votre stream, ainsi que l’endpoint de l’API Rules pour ce stream, le cas échéant. Elle inclut également des exemples de commandes curl et des instructions expliquant comment se connecter à l’endpoint du stream, ainsi que comment ajouter, DELETE et lister des règles par programmation à partir de l’endpoint de l’API Rules de votre stream.

Règles

L’onglet Règles est disponible pour les streams PowerTrack et offre un moyen rapide de démarrer en saisissant manuellement des règles en texte brut via l’interface utilisateur. Notez que l’interface permet d’ajouter jusqu’à 1000 règles par cette méthode manuelle et ne doit être utilisée que pour les tests initiaux. Nous recommandons de gérer vos règles par programmation via la Rules API dans tout environnement de production.

Paramètres

L’onglet Paramètres vous permet de modifier le format de sortie des data dans votre stream, plusieurs options de format étant prises en charge. Pour changer de format, utilisez simplement les boutons radio correspondant aux différentes options. La modification prendra effet lors de la reconnexion au stream. Notez que la mise à jour de ce paramètre s’appliquera immédiatement à la prochaine requête ou connexion et peut rompre la compatibilité de votre parseur avec le nouveau format. Veuillez noter : Le paramètre recommandé pour obtenir le plus de data est « Leave data in the original format », qui renverra des data au format natif enrichi ici. Le format des Activity streams est décrit ici.

Onglet Utilisation

L’onglet Utilisation offre une vue d’ensemble de l’utilisation de vos streams sur différentes périodes. Pour accéder par programmation aux informations d’utilisation, consultez l’API Usage.

Mensuel

La page d’utilisation mensuelle affiche votre utilisation du stream, ventilée par produit. Par exemple, les produits de couverture (tels que PowerTrack, Historical PowerTrack et PowerTrack Replay) pour une même source de data seront regroupés afin de fournir des data distinctes, ainsi qu’un total cumulé. Les décomptes incluent le cumul mensuel en cours, une estimation de fin de mois (fondée sur l’utilisation observée jusqu’à présent et le temps restant dans le mois), ainsi que les décomptes des deux mois précédents. À noter que ces décomptes sont dédupliqués pour chaque produit et pour chaque stream. Si vous avez reçu le même Post via plusieurs connexions au même stream PowerTrack, ce Post sera comptabilisé une seule fois à ces fins. Les décomptes sont mis à jour toutes les 24 heures à 00:00 UTC.

Quotidien

La page d’utilisation quotidienne fournit des décomptes dédupliqués pour chaque jour du mois en cours, répartis par produit. Les décomptes sont mis à jour toutes les 24 heures à 00:00 UTC.

Règles

Les limites de règles dépendent de votre forfait PowerTrack sous contrat et s’appliquent à tous les streams d’un « type » donné. Les décomptes sont mis à jour chaque fois qu’une règle est ajoutée ou supprimée.

Onglet « Compte »

Mon profil

Consultez les détails de votre profil utilisateur et modifiez votre mot de passe ici. Vous pouvez également configurer des notifications de seuil d’utilisation propres à votre compte. Les notifications relatives à l’état de l’API sont disponibles sur la page de statut à l’adresse https://api.twitterstat.us.

Paramètres du compte

Vous pouvez ajouter, supprimer et modifier des utilisateurs, et configurer des notifications par e‑mail pour des utilisateurs spécifiques ainsi que des alertes de seuil d’utilisation.
Veuillez noter qu’il existe trois types d’utilisateurs : Administrateur de compte, Utilisateur et E‑mail uniquement.  
  • Les administrateurs de compte sont autorisés à créer/supprimer/modifier d’autres utilisateurs et peuvent utiliser l’authentification de base avec nom d’utilisateur (e‑mail) et mot de passe pour se connecter aux API Enterprise
  • Les utilisateurs ne peuvent pas créer ni modifier d’autres utilisateurs, mais peuvent utiliser l’authentification de base avec nom d’utilisateur (e‑mail) et mot de passe pour se connecter aux API Enterprise
  • Les utilisateurs « E‑mail uniquement » n’ont pas accès au tableau de bord, ne sont pas autorisés à se connecter aux API Enterprise et ne reçoivent des notifications que s’ils sont configurés pour les recevoir dans la section Notifications.

Seuils d’utilisation

Configurez des seuils de volume pour vos produits. Ils déclencheront des alertes par e‑mail pour les utilisateurs qui ont activé ces notifications dans leur profil, pour le seuil d’avertissement comme pour le seuil critique de chaque produit.
Veuillez noter que ces seuils sont évalués une fois par jour à 19 h 30 (UTC) et ne le sont pas en temps réel.
I