Skip to main content

Report sull'utilizzo di Server

Il report sull'utilizzo di Server aiuta a comprendere le metriche relative a utenti, app, autorizzazioni, pianificazioni e processi, per consentirti di valutare rapidamente gli eventuali problemi di prestazioni, audit e conformità. Connettendoti a MongoDB e all'API di Server, puoi estrarre agevolmente dati e analisi pertinenti da Alteryx Server. Puoi scegliere il tipo di output che preferisci, inclusi dashboard Tableau, file separati e database, o generare macro di output per i processi a valle.

Puoi scaricare il report sull'utilizzo di Server da Alteryx Marketplace.

Requisiti

Il report sull'utilizzo di Server è compatibile con Designer versione 2023.2 e successive. Utilizza la patch più recente disponibile per la versione di Designer in uso.

Installazione dell'utilità e delle dipendenze del report di utilizzo di Server

Per installare il report sull'utilizzo di Server e le dipendenze associate, attieniti alla seguente procedura.

Installazione di YXI

  1. Scarica Server_Usage_Report.yxi da Alteryx Marketplace.

  2. Fai doppio clic sul file YXI per installare l'utility con Designer.

  3. Segui le istruzioni visualizzate:

    • Installa per il mio account: solo l'account utente avrà accesso all'utility sul computer. Posizione di installazione: %AppData%\Alteryx\.

    • Installazione per tutti gli utenti: tutti gli utenti avranno accesso all'utility sul computer. Posizione di installazione: %ProgramData%\Alteryx\.

  4. Al termine, apri il flusso di lavoro Guida introduttiva. In Designer, vai su Guida > Esempi di flussi di lavoro > Utilità aziendali > Report sull'utilizzo di Server > Guida introduttiva.

Installazione del connettore Output Tableau

Nota

Questo elemento è opzionale. Il connettore Output Tableau è necessario solo se si sceglie di scrivere l'output su Tableau. Il flusso di lavoro può funzionare senza Output Tableau, purché non si selezioni l'opzione di scrittura in Tableau.

  1. Scarica il connettore Output Tableau da Alteryx Marketplace.

  2. Fai doppio clic sul file YXI per installare il connettore utilizzando Designer.

  3. Segui le istruzioni visualizzate:

    • Installa per il mio account: solo l'account utente avrà accesso allo strumento sul computer. Posizione di installazione: %AppData%\Alteryx\.

    • Installa per tutti gli utenti: tutti gli utenti avranno accesso allo strumento sul computer. Posizione di installazione: %ProgramData%\Alteryx\.

Installazione del driver Simba per MongoDB

  1. Scarica il driver Simba dal portale Licenze Alteryx.

  2. Scorri fino in fondo alla sezione Download prodotti e seleziona Download a destra della voce Driver.

  3. Seleziona MongoDB dall'elenco delle versioni, quindi seleziona Avanti.

  4. Seleziona Download a destra della voce Simba MongoDB 2.3.22.1024 a 64 bit.

  5. Fai doppio clic sul file MSI per installare il driver nel sistema in uso. Ora il driver è accessibile nell'utilità Amministratore ODBC.

Impostazione di DSN per le connessioni MongoDB

Quindi, imposta DSN per le connessioni MongoDB. Segui i passaggi riportati di seguito.

  1. Apri Amministrazione origine dati ODBC (64 bit) sul computer.

  2. Crea una nuova origine dati utilizzando il Driver MongoDB ODBC per Simba (versione 2.03.22.1024).

  3. Compila i campi seguenti:

    • Nome origine dati: il campo può contenere qualsiasi cosa, ma deve essere compilato, anche se si utilizza temporaneamente la connessione ODBC.

    • Server: il nome del server.

    • Porta: la porta del server (27018 per MongoDB integrato).

    • Database: AlteryxService (o AlteryxGallery, a seconda del database che si sta aggiornando).

    • Meccanismo: SCRAM-SHA-256

    • Origine dell'autenticazione: associa il nome del database dall'input "d" riportato sopra.

    • Nome utente: il nome utente del database, di solito utente.

    • Password: la password del database. Controlla le Impostazioni di sistema Alteryx per la password MongoDB integrata.

  4. Seleziona Test... per assicurarsi che la connessione funzioni.

  5. Seleziona Opzioni avanzate...

  6. Aggiorna il valore Dimensione colonna binaria in 2147483647.

  7. Nella sezione Metadati in Meccanismo, seleziona File locale.

  8. Seleziona Sfoglia..., quindi il file dello schema appropriato che si trova nella cartella dello schema specifica per la versione di MongoDB:

    • Per le versioni fino a 2023.2:

      • File dello schema: MongoDB_Schema_23.2.json

      • Posizione di installazione utente: %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

      • Posizione di installazione amministratore: %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

    • Per le versioni 2024.1 e successive:

      • File dello schema: MongoDB_Schema_24.1Plus.json

      • Posizione di installazione utente: %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

      • Posizione di installazione amministratore: %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

  9. Seleziona Apri, quindi OK e di nuovo OK.

  10. Ripeti i passaggi precedenti per il database AlteryxService.

Creazione di connessioni DCM per MongoDB

Il passaggio successivo consiste nel creare connessioni per MongoDB in Data Connection Manager (DCM).

  1. Apri DCM. In Designer, vai a File > Gestisci connessioni.

  2. Nella scheda Origini dati seleziona + Nuova, quindi scegli il riquadro MongoDB.

  3. Dal menu a tendina Tecnologia, seleziona MongoDB ODBC.

  4. Seleziona Salva, quindi Credenziale Connect.

  5. Compila i campi seguenti:

    • Metodo di autenticazione: nome utente e password per MongoDB

    • Credenziale: crea una nuova credenziale.

    • Nome credenziale: specifica un nome a scelta, ad esempio MongoDB_AlteryxService_Local.

    • Vault: DCM

    • Nome utente: l'utente

    • Password: specifica la tua password.

    • Meccanismo di autenticazione: SCRAM-SHA-256.

    • Origine dell'autenticazione: AlteryxService.

    • Consenti connessione per SDK: opzione deselezionata.

  6. Seleziona Verifica connessione. Se la verifica ha esito positivo, seleziona Crea e collega.

  7. Ripeti la procedura per il database AlteryxGallery.

Creazione della connessione DCM all'API Server

  1. Apri DCM. In Designer, vai a File > Gestisci connessioni.

  2. Nella scheda Origini dati seleziona + Nuova, quindi scegli il riquadro Scarica.

    • Nome origine dati: specifica un nome a scelta (ad esempio, API Server).

    • URL di base: inserisci l'URL di base per l'API Server. Termina con /webapi/.

      Esempio: https://CompanyServerName/webapi/

  3. Seleziona Salva.

  4. Seleziona Connetti credenziale.

  5. Nel menu a discesa Metodo di autenticazione, seleziona Nome utente e password.

  6. Nel menu a discesa Credenziale seleziona Crea nuova credenziale.

    • Nome credenziale: specifica un nome a scelta (ad esempio, Chiavi dell'API Server).

    • Vault: seleziona DCM.

    • Nome utente: inserisci la tua chiave di accesso API, disponibile nel tuo profilo Gallery.

    • Password: inseriscila tua chiave privata di accesso API, disponibile nel tuo profilo Gallery.

  7. Seleziona Crea e collega.

(Facoltativo) Creazione della cache delle connessioni DCM e dei database di output

  1. Apri DCM. In Designer, vai a File > Gestisci connessioni.

  2. Seleziona + Nuova e scegli il riquadro MongoDB.

  3. Dal menu a tendina Tecnologia, seleziona il database desiderato e completa l'impostazione della connessione.

(Facoltativo) Creazione delle tabelle necessarie nei database di output

Esegui le seguenti applicazioni per creare le tabelle necessarie nei database di output. Questo passaggio è facoltativo in base alle preferenze. Inoltre, è facoltativo se il database della cache non viene utilizzato o se i dati non vengono inviati alle tabelle del database. Se si utilizza una delle due opzioni, esegui l'applicazione corrispondente.

  • Se si utilizza un database per memorizzare nella cache i pacchetti del flusso di lavoro scaricati da Gallery, esegui Crea tabelle di output database (app).

  • Se si utilizza un database per esportare i dati finali in tabelle, esegui l'app Crea tabelle di output database.

Esecuzione del report sull'utilizzo di Alteryx Server

Per eseguire il report sull'utilizzo di Server, attieniti alla seguente procedura:

  1. Inserisci le credenziali create nei passaggi precedenti:

    • Alteryx Gallery: connessione DCM al database AlteryxGallery.

    • Servizio Alteryx: connessione DCM al database AlteryxService.

    • Credenziali API: connessione DCM alle credenziali API Server.

    • Filtra i processi e i risultati in base alla data: limita le query sulle tabelle AS_Queue (processi) e AS_Results (messaggi dei risultati) in modo da restituire solo i risultati relativi a una data specifica.

    • Usa il database del flusso di lavoro memorizzato nella cache (facoltativo): consente di memorizzare i download del pacchetto app dalle chiamate API. Utilizza questa opzione se Designer contiene molti flussi di lavoro, poiché il download di ogni esecuzione può richiedere molto tempo.

    • Output in file hyper di Tableau: specifica dove desideri generare il file hyper di Tableau. Lascia questa impostazione predefinita se si tratta della prima esecuzione per testare la cartella di lavoro Tableau.

    • Output in tabelle del database (facoltativo): utilizza la connessione DCM per esportare i dati in tabelle separate nel tuo database.

    • Output in file separati (facoltativo):

      • (Facoltativo) Seleziona una posizione (cartella) per salvare i file separati. Vuoto = cartella .\Output.

      • (Facoltativo) Inserisci il prefisso. Vuoto = nessun prefisso.

      • Scegli il tipo di file (CSV o YXDB).

  2. Avvia il flusso di lavoro.

  3. Accedi alla cartella fornita per aprire la cartella di lavoro Tableau e visualizzare i dati. Se il file hyper è stato generato in una posizione diversa, ricollega l'origine dati all'interno di Tableau per visualizzare i dati.

Risoluzione dei problemi

Esaminare questa sezione per i problemi più comuni e le relative procedure di risoluzione.

Verifica delle autorizzazioni

Innanzitutto, assicurati che siano impostate le autorizzazioni corrette nell'interfaccia utente di Alteryx Server per scaricare i flussi di lavoro:

  • In Server, vai su Pannello di amministrazione > Impostazioni > Risorse: assicurati che l'opzione Disabilitazione download diretto non sia selezionata.

  • Gli utenti devono selezionare la casella di controllo Altri possono scaricare questo flusso di lavoro nelle impostazioni di ogni flusso di lavoro. Questa opzione è selezionata per impostazione predefinita, quindi a meno che non deselezionino esplicitamente la casella di controllo, il pacchetto del flusso di lavoro deve disporre delle autorizzazioni corrette.

  • Per ottenere i token API, l'utente che esegue il report di utilizzo di Server deve avere l'accesso API attivato.

Note aggiuntive per la risoluzione dei problemi

Esamina gli errori comuni e i passaggi di risoluzione suggeriti di seguito.

500 Risposta non trovata

Leggi questo articolo della community.

Report sull'utilizzo di Alteryx Server (8): PullServiceDetails (1483) - strumento n. 147 - errore interno - tentativo di lettura oltre la fine di un blob.

Controlla le impostazioni avanzate del DSN ODBC. La dimensione della colonna binaria deve essere 2147483647.

Report sull'utilizzo di Alteryx Server (8): Impossibile estrarre i dettagli del flusso di lavoro da Alteryx Server - errore interno del server HTTP/1.1 500.

Controlla se il flusso di lavoro è danneggiato. Conferma che può essere eseguito su Server.

Report sull'utilizzo di Alteryx Server (8): Impossibile estrarre i dettagli del flusso di lavoro da Alteryx Server - HTTP/1.1 403 non consentito

Verifica che il flusso di lavoro possa essere scaricato e che le impostazioni globali consentano il download dei flussi di lavoro. Quindi, controlla l'impostazione "Disabilitazione download diretto" in Amministratore > Impostazioni di Server.

HTTP/1.1 404 o HTTP/1.1 401 o "RetrieveServerOAuthToken: test "DownloadSucceeded" non riuscito"

Verifica che l'URL di base della connessione DCM sia "http://localhost/webapi/" (presta attenzione al suffisso /webapi e al carattere "/" in chiusura, non usare /Gallery/ qui).

Verifica che la chiave di accesso (nome utente) e il segreto di accesso (password) della connessione DCM siano corretti.

Verifica che AlteryxService sia in esecuzione e che sia possibile accedere alla documentazione di Gallery o Swagger (API). In caso contrario, prova a riavviare AlteryxService in "servizi".

In questa sezione: