Console Gnip

​

Panoramica

La console Enterprise (su console.gnip.com) è disponibile per i clienti Enterprise dei dati con accesso all’API Enterprise previsto da contratto. Se al momento non sei un cliente Enterprise dei dati ma desideri maggiori informazioni, puoi approfondire i dati Enterprise qui.

Questa è una panoramica della dashboard della console Enterprise di X. Le sezioni trattate riguardano le singole aree della console relative ai dettagli dei prodotti, all’utilizzo e alla gestione generale dell’account. Se hai domande sul tuo account specifico, contatta il tuo account manager dedicato oppure consulta la nostra documentazione tecnica per i prodotti Enterprise.

Come parte della prova Enterprise e del processo di onboarding con il tuo account manager, i clienti Enterprise riceveranno credenziali per l’accesso a console.gnip.com, l’interfaccia utente in cui è possibile verificare e configurare l’accesso ai prodotti Enterprise. L’accesso iniziale alla console per l’amministratore del cliente viene configurato da X nell’ambito dell’onboarding Enterprise e gli amministratori possono quindi aggiungere altri utenti. La console Enterprise consente di gestire e consultare ulteriori dettagli relativi ai prodotti Enterprise. 

Il seguente video offre una panoramica delle diverse sezioni della dashboard di console.gnip.com. 

Avvertenza: tieni presente che alcune delle funzionalità mostrate nel video, incluse specifiche arricchiture dello stream e prodotti basati su sorgenti dati non X, potrebbero non essere più disponibili.

​

Scheda Products

Dopo aver effettuato l’accesso al tuo account su console.gnip.com, verrai indirizzato alla scheda Products della dashboard. Questa pagina include una panoramica dei prodotti Enterprise attualmente disponibili per il tuo account.

Per i prodotti che utilizzano la consegna in streaming, come PowerTrack o Decahose, questa pagina elenca il nome del prodotto e l’etichetta dello stream, il numero di connessioni attive, il numero di regole attualmente attive per ciascuno (ove applicabile) e il conteggio grezzo delle attività (ad esempio, Post) consegnate nelle ultime 24 ore.

Per i prodotti con consegna REST, come la Search API, questa pagina elenca il nome del prodotto, le etichette (indicate anche come “streams”), le attività correnti (ad esempio, Post) restituite tramite questi endpoint e alcuni conteggi delle richieste per endpoint.

Nota che la Usage API fornisce gran parte di questi dati in modo programmatico.

Dettagli specifici per stream sono disponibili facendo clic sul nome o sul pulsante Impostazioni.

​

Panoramica

Facendo clic su uno degli stream nella dashboard principale verrai portato a una pagina di panoramica di quello stream.

Per i prodotti con consegna in streaming, questa pagina include:

1. Un grafico del volume delle attività consegnate tramite ciascuna specifica connessione dello stream

2. Dettagli (id di connessione e indirizzo IP) sulle connessioni attualmente attive nello stream

3. Un registro dei recenti eventi di connessione, disconnessione e aggiornamento delle regole per il tuo stream

Nota: la scala del grafico può essere regolata tramite i link nell’angolo in alto a destra. La visibilità delle singole connessioni e disconnessioni può essere attivata o disattivata facendo clic sulla relativa voce nella legenda direttamente sotto il grafico.

​

Connessioni

La pagina Connessioni fornisce dettagli sugli eventi di connessione recenti nel tuo stream. Include l’ora di inizio e fine di ciascuna connessione (in formato 24 ore, UTC), la durata di ogni connessione, l’indirizzo IP del server che ha effettuato la connessione, un id di connessione univoco a scopo di riferimento e lo stato attuale della connessione. Lo stato corrisponde all’evento più recente per la connessione specificata, ossia Client Connected oppure una disconnessione, con il relativo tipo di disconnessione indicato. Per ulteriori dettagli sul debugging delle connessioni, visita la guida sulle disconnessioni.

​

Guida all’API

La pagina Guida all’API fornisce gli URL degli endpoint API per il tuo stream, nonché, ove applicabile, l’endpoint della Rules API per lo stream. Inoltre, include comandi curl di esempio e istruzioni su come connettersi all’endpoint dello stream e su come aggiungere, eliminare ed elencare in modo programmatico le regole dall’endpoint della Rules API del tuo stream.

​

Regole

La scheda Regole è disponibile per gli stream PowerTrack e offre un modo rapido per iniziare inserendo manualmente regole in testo semplice tramite l’interfaccia utente. Nota che l’interfaccia consente di aggiungere al massimo 1000 regole con questo metodo manuale e dovrebbe essere utilizzata solo per i test iniziali. Consigliamo di gestire le regole in modo programmatico tramite la Rules API in qualsiasi ambiente di produzione.

​

Impostazioni

La scheda Impostazioni consente di modificare il formato di output dei dati nel tuo stream, per il quale sono supportate più opzioni. Per cambiare formato, utilizza i pulsanti di opzione che indicano le diverse scelte. La modifica avrà effetto al momento della riconnessione allo stream. Tieni presente che l’aggiornamento di questa impostazione verrà applicato immediatamente alla richiesta o connessione successiva e potrebbe causare errori nel tuo parser a causa del nuovo formato.

Nota: L’impostazione consigliata per ottenere il maggior numero di dati è “Lascia i dati nel formato originale”, che restituirà i dati nel formato nativo arricchito qui. Il formato activity streams è descritto qui.

​

Scheda Usage

La scheda Usage offre una panoramica dell’utilizzo dei tuoi stream in diversi intervalli di tempo. Per accedere in modo programmatico alle informazioni sull’utilizzo, consulta la Usage API.

​

Mensile

La pagina Monthly Usage mostra l’utilizzo dello stream suddiviso per prodotto. Ad esempio, i prodotti di coverage (ad esempio PowerTrack, Historical PowerTrack e PowerTrack Replay) per una determinata fonte di data saranno raggruppati per fornire dati distinti, oltre a un conteggio aggregato complessivo. I conteggi includono il valore dall’inizio del mese, la stima di fine mese (basata sull’utilizzo registrato finora e sul tempo rimanente del mese) e i conteggi dei due mesi precedenti.

In particolare, questi conteggi sono deduplicati per ciascun prodotto e stream. Se hai ricevuto lo stesso Post tramite più connessioni allo stesso stream PowerTrack, quel Post verrà conteggiato una sola volta per queste finalità. I conteggi vengono aggiornati ogni 24 ore alle 00:00 UTC.

​

Giornaliero

La pagina Daily Usage fornisce conteggi giornalieri deduplicati per ogni giorno del mese in corso, suddivisi per prodotto. I conteggi vengono aggiornati ogni 24 ore alle 00:00 UTC.

​

Regole

I limiti delle regole si basano sul pacchetto di regole PowerTrack previsto dal tuo contratto e si applicano a tutti gli stream di un determinato “type”. I conteggi vengono aggiornati ogni volta che una nuova regola viene aggiunta o eliminata.

​

Scheda account

​

Il mio profilo

Qui puoi visualizzare i dettagli del tuo profilo utente e cambiare la password. Puoi anche configurare avvisi sulle soglie di utilizzo specifici per il tuo account. Gli avvisi sullo stato dell’API sono disponibili nella pagina di stato all’indirizzo https://api.twitterstat.us.

​

Impostazioni dell’account

Puoi aggiungere, rimuovere e modificare gli utenti e configurare le notifiche email per singoli utenti e gli avvisi sulle soglie di utilizzo.

Nota: esistono tre tipologie di utenti: Account Admin, User ed Email Only.  

• Gli Account Admin possono creare/eliminare/modificare altri utenti e utilizzare l’autenticazione di base con nome utente (email) e password per connettersi alle API Enterprise

• Gli User non possono creare o modificare altri utenti, ma possono utilizzare l’autenticazione di base con nome utente (email) e password per connettersi alle API Enterprise

• Gli utenti Email Only non hanno accesso alla dashboard, non sono autorizzati a connettersi alle API Enterprise e ricevono solo notifiche, se configurati per riceverle nella sezione Notifications.

​

Soglie di utilizzo

Configura le soglie di volume per i tuoi prodotti. Queste attiveranno avvisi via email per gli utenti che hanno configurato tali notifiche nei rispettivi profili, sia per la soglia di avviso che per la soglia critica di ciascun prodotto.

Tieni presente che queste soglie vengono valutate una volta al giorno alle 19:30 (UTC) e non sono elaborate in tempo reale.