Conserver l'intégrité des statistiques lors des mises à niveau parallèles, de la migration des métadonnées ou du clonage

Mise à niveau parallèle ou migration de métadonnées avec Platform Analytics

Platform Analytics est un outil de télémétrie qui prend en charge la capture de télémétrie à partir de plusieurs déploiements MicroStrategy simultanément. Platform Analytics dispose d'une manière unique d'identifier chaque connexion de métadonnées à Intelligence Server.

Lorsqu'un administrateur reconfigure Intelligence Server avec une sauvegarde de métadonnées différente, Platform Analytics reconnaît immédiatement le changement et commence à enregistrer une nouvelle télémétrie associée aux nouvelles métadonnées.

Selon votre objectif, aucune autre action n'est requise. Par exemple, si vous avez créé un deuxième environnement en tant qu'environnement de test ou de bac à sable. Si vous souhaitez continuer à capturer la télémétrie sous le même référentiel de métadonnées, voir ci-dessous :

Si l'un des paramètres suivants change, Platform Analytics considère que vos métadonnées sont nouvelles et une ligne supplémentaire apparaît dans lu_metadata table :

• métadonnées_guid Un GUID de métadonnées unique est généré et enregistré lorsque de nouvelles métadonnées sont créées via l'assistant de configuration.
• hôte Le serveur qui héberge le serveur de la base de données.
• port Le port sur lequel le serveur de base de données s'exécute.
• base de données Le nom de la base de données de métadonnées.
• uid/sid Ce champ est uniquement utilisé pour les bases de données Oracle.

Les paramètres répertoriés ci-dessus sont traités en fonction des valeurs fournies dans le DSN de métadonnées. Le DSN de métadonnées se trouve dans votre odbc.ini fichier pour Linux et le ODBC Administrateur de sources de données pour Windows.

Pour restaurer la télémétrie et éventuellement s'assurer que toute la télémétrie est capturée, effectuez les étapes suivantes :

1. Maintenez vos services Platform Analytics opérationnels. Par exemple, Zookeeper, Kafka, PAconsumer, REDIS, etc.
2. Pour s'assurer éventuellement que Platform Analytics a terminé le traitement de la télémétrie existante avant d'apporter des modifications de configuration, vérifiez le nombre de correspondances dans les messages de télémétrie pour les sujets décalés ou s'ils diffèrent d'une quantité négligeable entre Telemetry Server (par exemple, Kafka) et le référentiel Platform Analytics :
   1. MicroStrategy vous suggère de vérifier les messages à partir des sujets principaux ou des zones d'objet suivants :
      1. Statistiques du rapport
      2. IsDocumentStats
      3. IsSessionStats
   2. Pour obtenir le résultat de Telemetry Server, allez dans son répertoire d'installation (Par exemple, opt/ MicroStrategy/Messaging Services/Kafka/kafka xx.xx/bin) et exécutez la requête suivante :
      Copier

      ./kafka-run-class.sh kafka.tools.GetOffsetShell --broker-list <ip:port> --topic <topic> --time -1

   3. Pour obtenir le résultat du référentiel Platform Analytics, connectez-vous au référentiel via la base de données Recherchez l'outil de requête ou un autre éditeur de requête et exécutez la requête suivante :

      Copier

      select * from platform_analytics_wh.lu_topic_partition_offset where id like '%<topic>%'

3. Reconfigurer Intelligence Server avec de nouvelles métadonnées.

4. Connectez-vous au référentiel Platform Analytics via l'outil DB Requête ou un autre éditeur de requêtes et vérifiez que la nouvelle entrée dans lu_metadata La table est remplie.

   

5. Arrêtez le processus Platform Analytics Consumer (PAconsumer).

6. À l'aide de l'outil DB Requête, permutez les métadonnées_ID dans la table lu_metadata en utilisant un métadonnées_ID modifié temporairement pour éviter les exceptions de clé primaire :

   Contour

   Copier

   UPDATE lu_metadata SET metadata_id = 'TEMPORARY_MD_ID' WHERE metadata_db_connection = 'OLD_MD_CONNECTION';
   UPDATE lu_metadata SET metadata_id = 'OLD_MD_ID' WHERE metadata_db_connection = 'NEW_MD_CONNECTION';
   UPDATE lu_metadata SET metadata_id = 'NEW_MD_ID' WHERE metadata_db_connection = 'OLD_MD_CONNECTION';

   Exemple

   Copier

   UPDATE lu_metadata SET metadata_id = '7051653456108457985' WHERE metadata_db_connection = 'host=10.23.35.94;port=5432;database=platform_metadata;';
   UPDATE lu_metadata SET metadata_id = '7051653456108457984' WHERE metadata_db_connection = 'host=127.0.0.1;port=5432;database=platform_metadata;';
   UPDATE lu_metadata SET metadata_id = '7051946829721636864' WHERE metadata_db_connection = 'host=10.23.35.94;port=5432;database=platform_metadata;';

7. Démarrez le client Platform Analytics.

8. Confirmez que les transactions sont mappées vers l'ID de métadonnées correct à l'aide de la requête suivante. Les nouvelles entrées doivent avoir l'ancien métadonnées_id et la nouvelle metdata_db_connection.

   Copier

   SELECT object_name, m.metadata_id, metadata_db_connection, tran_timestamp
   FROM access_transactions a
       JOIN lu_object o ON a.object_id = o.object_id
       JOIN lu_project p ON o.project_id = p.project_id
       JOIN lu_metadata m ON p.metadata_id = m.metadata_id
   WHERE tran_timestamp > NOW() - INTERVAL '5 MINUTE'
   ORDER BY tran_timestamp DESC;

9. Purger l'entrepôt Platform Analytics pour supprimer tous les objets dans les métadonnées avec l'ID de métadonnées inutilisé à l'aide de la requête suivante :

   Copier

   doTestBeforePurge: true
   commandsToExecute:
   #  - commandName: DELETE_ALL_DELETED_OBJECTS
   
   #  - commandName: DELETE_ALL_DELETED_PROJECTS
   
     - commandName: DELETE_ALL_OBJECTS_IN_METADATA
       metadataList:
         - METADATA_ID_TO_BE_PURGED
   #      - metadataId_2