Utilità di verifica dello stato di Platform Analytics

L'utilità di verifica dello stato di Platform Analytics è un controllo dello stato end-to-end. Questa utilità risolve i problemi relativi a più componenti necessari per produrre, utilizzare e generare report sui dati di telemetria dalla piattaforma. In particolare, questa verifica è consigliata se un report in uno dei progetti non fornisce i dati di telemetria al warehouse di Platform Analytics.

L'utilità di controllo dello stato di Platform Analytics esegue tutti e tre i controlli dello stato di Controlli dello stato di avvio e controlli di telemetria end-to-end per verificare che i dati possano essere prodotti da Intelligence Server e utilizzati dal consumer di Platform Analytics (archivio di telemetria).

Se si utilizza Linux, l'utilità di verifica dello stato di Platform Analytics si trova all'indirizzo /opt/MicroStrategy/PlatformAnalytics/bin. Se si utilizza Windows, si trova in C:\Program Files (x86)\MicroStrategy\Platform Analytics\bin.

Come eseguire l'utilità di verifica dello stato di Platform Analytics

Per eseguire un controllo dello stato di Platform Analytics end-to-end, eseguire platform-analytics-health-check.(sh/bat) utilità.

I controlli di telemetria end-to-end eseguiti dall'utilità Verifica integrità di Platform Analytics includono:

Verifica integrità
Controllo dello stato di Redis
Controllo dello stato di Kafka
Verifica integrità registro di modifiche
Verifica integrità delle statistiche

Verifica integrità

Durante il controllo dello stato, vengono eseguiti due controlli:

Il consumatore/produttore può connettersi al database fornito durante l'installazione e archiviato in PAConsumerConfig.yaml file di configurazione? In caso contrario, verranno eseguiti ulteriori test di connettività di rete per diagnosticare la causa del problema.
L’utente database possiede i privilegi necessari? Per un elenco completo dei prerequisiti di installazione, vedere Prerequisiti di Platform Analytics.

Il report Verifica integrità fornisce un elenco dei privilegi e dello stato risultante. Se tutte le verifiche hanno esito positivo, verrà visualizzata la riga finale Warehouse health check result is healthy.

Se una riga qualsiasi è letta Failed, controlla il tuo PAConsumerConfig.yaml e verificare che il database disponga dei privilegi corretti.

Risoluzione dei problemi suggerita per errori di controllo dello stato

Se si riceve uno dei seguenti errori durante la verifica dello stato di salute, ecco le soluzioni per aggirare il problema:

Errore di privilegi mancanti

Se l'utente del database archiviato in PAConsumerConfig.yaml Privilegi non presenti nel file di configurazione INFO [privilege type] privilege: Failed. Per risolvere questo errore, l’amministratore deve concedere i privilegi mancanti all’utente del database e riavviare il consumer.

Come concedere i privilegi mancanti:

Interrompere il consumer di Platform Analytics e il producer di metadati di Usher.
Effettuare la connessione al server di database che contiene Platform Analytics Repository. Eseguire il seguente comando, sostituendo 'someuser' e 'somehost' con le informazioni specificate dal cliente:
Copia
```
GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’;
```
Riavviare il consumer di Platform Analytics e il producer di metadati di Usher.

Errore di connessione non riuscita

Se il consumatore o il produttore non è in grado di connettersi al database utilizzando la configurazione specificata in PAConsumerConfig.yaml configurazione, è possibile che venga visualizzato il seguente errore:

Copia

2018-11-21 21:43:28,793 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:45:31,797 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:47:34,800 ERROR HealthCheck main - Failed to connect to the database using url:jdbc:mysql://XX.Y.Z.1:3306/platform_analytics_wh?rewriteBatchedStatements=true&useLegacyDatetimeCode=false&serverTimezone=UTC. Please double check your connection parameters.
Communications link failure

Il/La PAConsumerConfig.yaml viene popolato in base alle informazioni di database fornite durante l’installazione. Per risolvere l'errore, connettersi al computer che ospita Platform Analytics e confermare tutti i campi sotto a warehouseDbConnection intestazione sono corretti in PAConsumerConfig.yaml file.

Errore password dell'utente del database non corretta

Il consumatore o il produttore non potranno connettersi al database se la password del warehouse crittografata non è corretta. Per generare una nuova password criptata e aggiornare la conferma, vedere Aggiornamento della password dell'utente del database configurato al repository di Platform Analytics .

Utente del database creato con errore di SSL attivato

Platform Analytics supporta le versioni 5.6, 5.7 e 8.0 di MySQL. Per MySQL 8.0, il collegamento SSL è attivo per impostazione predefinita. Attualmente, Platform Analytics non supporta SSL per l'utente del database che si collega a MySQL. Quando si crea l'utente del database per Platform Analytics Consumer o Usher Metadata Producer, specificare l'opzione SSL/TLS utilizzando REQUIRE clausola.

Come disattivare SSL:

Collegarsi al repository di Platform Analytics ed eseguire il seguente comando:
Copia
```
show variables like '%ssl%';
```
Se il risultato per 'have_ssl' è 'YES' SSL è abilitato. Crea l'utente con mysql_native_password e REQUIRE NONE opzioni per connettersi senza SSL.
Copia
```
CREATE USER 'test'@'%' IDENTIFIED WITH mysql_native_password BY 'password' REQUIRE NONE;
```

Controllo dello stato di Redis

Il controllo dello stato di Redis stabilisce se il consumer o il producer riesce a collegarsi al server Redis. Il controllo fornisce statistiche dettagliate su Redis raccolte durante l'avvio. Se tutte le verifiche hanno esito positivo, verrà visualizzata la riga finale Redis server health check result is healthy.

Se viene visualizzato un errore durante la verifica, assicurarsi che Redis sia in esecuzione e che la configurazione sia corretta in PAConsumerConfig.yaml file.

Risoluzione dei problemi suggerita per il controllo dello stato di salute di Redis Errori

Se si riceve uno dei seguenti errori nel file Redis Per il controllo dello stato di salute, ecco le soluzioni alternative suggerite:

Errore di fermo di Redis

Se il consumer o il producer non è in grado di collegarsi a Redis, potrebbe essere in uno stato di fermo. Per risolvere l'errore, avviare la cache in memoria di MicroStrategy, il consumer di Platform Analytics e il producer di metadati di Usher.

Connessione non riuscita all'errore di Redis

Se il consumatore o il produttore non è in grado di connettersi a Redis, è possibile che la configurazione non sia corretta in PAConsumerConfig.yaml file. Per risolvere l'errore, connettersi al computer che ospita Platform Analytics e confermare tutti i campi sotto a redisConnection intestazione sono corretti in PAConsumerConfig.yaml file.

È possibile che il server Redis non sia riuscito a scrivere lo snapshot sul disco. In questo caso, è possibile disabilitare il processo di creazione di istantanee RDP sul server Redis.

Arrestare il platform-analytics-usher-lookup-producer utilizzando il seguente comando:
Copia
```
./platform-analytics-usher-lookup-producer.sh stop
```
Arrestare il platform-analytics-consumer utilizzando il seguente comando:
Copia
```
./platform-analytics-consumer.sh stop
```
Arrestare il server Redis.
Applica le seguenti modifiche al file redis.conf:
1. Commenta le tre righe sotto il ###SNAPSHOTTING### intestazione.
  Copia
```
#save 900 1
#save 300 10
#save 60 10000
```
2. Nella stessa sezione, immettere la riga:
  Copia
```
save ""
```
Avviare il server Redis.
Avviare platform-analytics-consumer utilizzando il seguente comando:
Copia
```
./platform-analytics-consumer.sh start
```
Avviare platform-analytics-usher-lookup-producer utilizzando il seguente comando:
Copia
```
./platform-analytics-usher-lookup-producer.sh start
```

Autenticazione password abilitata per Redis Errore

Se il consumer o il producer non è in grado di collegarsi a Redis, probabilmente l'autenticazione della password è attiva. In base alle impostazioni predefinite, Redis non è configurato con l'autenticazione della password, ma può impostare dopo l'installazione.

Se Redis è stato abilitato con l'autenticazione tramite password e la password non è presente in PAConsumerConfig.yaml di configurazione, il consumatore o il produttore non sarà in grado di connettersi a Redis. Per risolvere questo errore, seguire i passaggi di Attivazione dell'autenticazione della password sulla cache di telemetria di MicroStrategy.

Controllo dello stato di Kafka

Kafka Health Check garantisce l'avvio e la connessione di Gestore telemetria (Apache Zookeeper) e Server di telemetria (Server Kafka). Se tutte le verifiche hanno esito positivo, verrà visualizzata la riga finale Kafka cluster health check result is healthy.

Poiché il server di telemetria dipende dalla gestione della telemetria, occorre innanzitutto avviare quest'ultima.

Se si vede un errore nel controllo, assicurarsi che ZooKeeper e Kafka vengano avviati.

Consigli per la risoluzione dei problemi per gli errori di Kafka Health Check

Come verificare se i server ZooKeeper sono in esecuzione su tutti i nodi:

In Linux, eseguire il comando seguente per eseguire il PID.

Copia

ps ax | grep java | grep -i QuorumPeerMain | grep -v grep | awk '{print $1}'

In Windows, aprire i servizi di Windows e verificare che il servizio \"Apache ZooKeeper\" sia in esecuzione.

Come verificare se i server Kafka sono in esecuzione su tutti i nodi:

In Linux, eseguire il comando seguente per eseguire il PID.

Copia

ps ax | grep -i 'server.prop'| grep java | grep -v grep | awk '{print $1}'

In Windows, aprire i servizi di Windows e verificare che il servizio \"Apache Kafka\" sia in esecuzione.

Come avviare ZooKeeper e Kafka su tutti i nodi:

In Linux, eseguire i seguenti comandi nella directory Kafka:

Copia

# Start Zookeeper on all nodes,
./zookeeper-server-start.sh -daemon ../config/zookeeper.properties
# Start Kafka on all nodes,
./kafka-server-start.sh -daemon ../config/server.properties

In Windows, aprire i servizi di Windows e avviare Apache ZooKeeper e Apache Kafka.

Se questo è un ambiente raggruppato con più nodi di ZooKeeper e Kafka, occorre innanzitutto avviare tutti i nodi di ZooKeeper.

Verifica integrità registro di modifiche

La verifica del registro di sistema delle revisioni garantisce che il consumer di Platform Analytics sia integro. Per questa verifica, è necessario fornire il GUID del progetto e il GUID del report da testare. Viene richiesto di modificare la descrizione del report, che genera un registro delle revisioni. Il test verifica se il produttore di Intelligence Server ha prodotto il log per l'argomento Mstr.PlatformAnalytics.ChangeJournal.CubesReportsDashboard Kafka. Verifica quindi se il log è stato elaborato e scritto nella tabella warehouse di Platform Analytics lu_object.

Se il record si trova sia nell'argomento Kafka appropriato sia nel warehouse, verrà letta la riga finale Change Journal health check result is healthy.

Se si verifica un errore durante la verifica, assicurarsi che il flag Servizio di messaggistica per Platform Analytics sia selezionato nell'Intelligence Server e che la proprietà Server di telemetria abilitato sia impostata su True nell'Intelligence Server.

Risoluzione dei problemi suggerita per gli errori del controllo dello stato del registro di revisioni

Verificare che Intelligence Server sia configurato per scrivere i dati di telemetria in Kafka

Utilizzando Command Manager, connettersi a Intelligence Server.
Per visualizzare lo stato del flag funzionalità, eseguire il comando:
Copia
```
LIST ALL FEATURE FLAGS;
```
Nei risultati, verificare di Servizio di messaggistica per Platform Analytics flag funzionalità è ATTIVATA. Se il flag funzionalità è DISATTIVATO, eseguire il seguente comando per attivarlo:
Copia
```
ALTER FEATURE FLAG "Messaging Service for Platform Analytics" ON;
```
Per visualizzare lo stato di Server di telemetria abilitato proprietà, eseguire il comando:
Copia
```
LIST PROPERTIES FOR SERVER CONFIGURATION;
```
Nei risultati, verificare di Server di telemetria abilitato La proprietà è impostata su Vero. Se la proprietà è impostata su Falso, eseguire il comando seguente:

Sostituisci <kafka server IP> con l’indirizzo IP del server Kafka.
Copia
```
'ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers: <kafka server IP>:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";
```
Riavviare Intelligence Server.

Verificare che il consumer di Platform Analytics funzioni

In Linux:

Passare alla cartella in cui è installato Platform Analytics.
```
<Install>/PlatformAnalytics/bin
```
Eseguire il seguente comando:
Copia
```
./platform-analytics-consumer.sh status
```
Avviare o riavviare il server con il seguente comando:
Copia
```
./platform-analytics-consumer.sh start
```

Se il riavvio del server non risolve il problema, consultare i registri in <Install>/PlatformAnalytics/log/platform-analytics-consumer.log oppure contattare l'Assistenza tecnica MicroStrategy allegando la cartella <Install>/PlatformAnalytics/log al tuo caso.

In Windows:

Aprire Servizi Windows utilizzando services.msc.
Avviare o riavviare l'archivio di telemetria.

Verifica integrità delle statistiche

Questo controllo dello stato garantisce che il consumatore di Platform Analytics possa elaborare le statistiche dei report. Viene richiesto di eseguire il report dal controllo dello stato precedente. Verrà generato un log nell'argomento Mstr.PlatformAnalytics.IsReportStats. Il controllo dello stato verifica che il produttore di Intelligence Server abbia prodotto il record per Kafka e che si trovi nel warehouse di Platform Analytics.

Se il record si trova sia nell'argomento Kafka appropriato sia nel warehouse, verrà letta la riga finale Statistics health check result is healthy.

Se viene visualizzato un errore durante la verifica, verificare che le statistiche siano abilitate per il progetto e che Messaging Services sia configurato correttamente.

Risoluzione dei problemi suggerita per gli errori di controllo dello stato delle statistiche

Verificare che le statistiche siano abilitate per il progetto

Utilizzando Command Manager, connettersi all'Intelligence Server.
Eseguire il comando:

Sostituire <nome progetto> con il nome del progetto.
Copia
```
LIST ALL PROPERTIES FOR PASTATISTICS IN PROJECT "<Project Name>";
```
Nei risultati verificare che la proprietà Statistiche di base sia impostata su Vero. Se è impostato su Falso, eseguire il comando seguente:

Sostituire <nome progetto> con il nome del progetto.
Copia
```
ALTER PASTATISTICS BASICSTATS ENABLED DETAILEDREPJOBS TRUE DETAILEDDOCJOBS TRUE JOBSQL TRUE COLUMNSTABLES TRUE IN PROJECT "<Project Name>";
```
Riavviare Intelligence Server.

Verificare che il consumer di Platform Analytics funzioni

In Linux:

Passare alla cartella in cui è installato Platform Analytics.
```
<Install>/PlatformAnalytics/bin
```
Eseguire il seguente comando:
Copia
```
./platform-analytics-consumer.sh status
```
Avviare o riavviare il server con il seguente comando:
Copia
```
./platform-analytics-consumer.sh start
```

In Windows:

Aprire Servizi Windows utilizzando services.msc.
Avviare o riavviare l'archivio di telemetria.