Skip to main content

Rapport d'utilisation de Server

Utilisez le Rapport d'utilisation de Server pour comprendre les mesures des utilisateurs, des applications, des autorisations, des planifications et des tâches afin d'évaluer rapidement les problèmes de performances, d'audit et de conformité. Connectez-vous à votre MongoDB et à votre API Server pour extraire facilement des données et des analyses pertinentes de votre Alteryx Server. Vous pouvez choisir votre format de sortie préféré, notamment : tableau de bord Tableau, fichiers séparés, base de données, sorties de macro pour les processus en aval.

Vous pouvez télécharger le rapport d'utilisation de Server à partir d'Alteryx Marketplace.

Configuration requise

Le rapport d'utilisation de Server est compatible avec Designer version 2023.2 et ultérieure. Utilisez le correctif le plus récent disponible pour votre version de Designer.

Installer l'utilitaire de rapport d'utilisation de Server et ses dépendances

Suivez ces étapes pour procéder à l'installation du rapport d'utilisation de Server et des dépendances requises.

Installation de YXI

  1. Téléchargez le fichier Server_Usage_Report.yxi à partir d'Alteryx Marketplace.

  2. Double-cliquez sur le fichier YXI pour installer l'utilitaire avecDesigner.

  3. Suivez les instructions :

    • Installer pour mon compte : seul votre compte utilisateur aura accès à l'utilitaire sur cette machine. Installation dans : %AppData%\Alteryx\.

    • Installer pour tous les utilisateurs : tous les utilisateurs auront accès à l'utilitaire sur cette machine. Installation dans : %ProgramData%\Alteryx\.

  4. Une fois le processus terminé, lancez le workflow « Pour commencer ». Dans Designer, accédez à Aide > Exemple de workflows > Utilitaires d'entreprise > Rapport d'utilisation de Server > Pour commencer.

Installer le connecteur Sortie Tableau

Note

Option facultative. Le connecteur Sortie Tableau est requis uniquement si vous choisissez d'écrire les données de sortie dans Tableau. Le workflow peut fonctionner sans Sortie Tableau tant que vous ne sélectionnez pas l'option d'écriture dans Tableau.

  1. Téléchargez le connecteur Sortie Tableau à partir d'Alteryx Marketplace.

  2. Double-cliquez sur le fichier YXI pour installer le connecteur via Designer.

  3. Suivez les instructions :

    • Installer pour mon compte : seul votre compte utilisateur aura accès à l'outil sur la machine. Installation dans : %AppData%\Alteryx\.

    • Installer pour tous les utilisateurs : tous les utilisateurs auront accès à l'outil sur cette machine. Installation dans : %ProgramData%\Alteryx\.

Installer le pilote Simba pour MongoDB

  1. Téléchargez le pilote Simba depuis le portail Licences Alteryx.

  2. Faites défiler jusqu'au bas de la section Téléchargements de produits et sélectionnez Télécharger à droite de l'entrée Pilotes.

  3. Sélectionnez MongoDB dans la liste des versions, puis Suivant.

  4. Sélectionnez Télécharger à droite de l'entrée Simba MongoDB 2.3.22.1024 64 bits.

  5. Double-cliquez sur le fichier MSI pour installer le pilote sur votre ordinateur. Le pilote est désormais accessible dans l'utilitaire Administrateur ODBC.

Configurer un DSN pour les connexions MongoDB

Ensuite, configurez un DSN pour les connexions à MongoDB. Suivez les étapes ci-dessous.

  1. Ouvrez l'Administrateur de sources de données ODBC (64 bits) sur votre machine.

  2. Créez une nouvelle source de données à l'aide du pilote Simba MongoDB ODBC (version 2.03.22.1024).

  3. Renseignez les champs suivants :

    • Nom de la source de données : ce champ est libre, mais il doit être renseigné (même temporairement lors de l'utilisation de la connexion ODBC).

    • Serveur : le nom de votre serveur.

    • Port : le port de votre serveur (27018 pour MongoDB intégrée).

    • Base de données : AlteryxService (ou AlteryxGallery, selon la base de données que vous mettez à jour).

    • Mécanisme : SCRAM-SHA-256

    • Source d'authentification : assurez-vous que le nom de la base de données correspond à celui spécifié dans l'entrée « d » ci-dessus.

    • Nom d'utilisateur : nom d'utilisateur de la base de données, généralement utilisateur.

    • Mot de passe : mot de passe de la base de données. Vérifiez le mot de passe de MongoDB intégrée dans les paramètres système d'Alteryx.

  4. Sélectionnez Test pour vérifier que la connexion est fonctionnelle.

  5. Sélectionnez Options avancées....

  6. Modifiez la valeur de la taille de la colonne binaire pour qu'elle soit égale à2147483647.

  7. Dans la section Métadonnées, sous Mécanisme, sélectionnez Fichier local.

  8. Sélectionnez Parcourir…, puis le fichier de schéma approprié situé dans le dossier correspondant à la version de MongoDB.

    • Pour les versions antérieures à jusqu'à 2023.2 :

      • Fichier de schéma : MongoDB_Schema_23.2.json

      • Emplacement installation utilisateur : %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

      • Emplacement installation administrateur : %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

    • Pour les versions 2024.1 et ultérieures :

      • Fichier de schéma : MongoDB_Schema_24.1Plus.json

      • Emplacement installation utilisateur : %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

      • Emplacement installation administrateur : %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

  9. Sélectionnez Ouvrir, puis OK deux fois.

  10. Répétez ces étapes pour la base de données AlteryxService.

Créer des connexions DCM pour MongoDB

L'étape suivante consiste à créer des connexions MongoDB dans le Gestionnaire de connexions aux données (DCM).

  1. Ouvrez DCM. Dans Designer, accédez à Fichier > Gérer les connexions.

  2. Dans l'onglet Sources de données, sélectionnez + Nouveau et choisissez la vignette MongoDB.

  3. Dans le menu déroulant Technologie, sélectionnez MongoDB ODBC ».

    • Nom de la source de données : saisissez le nom de source de données AlteryxService comme définit dans la section Configurer un DSN pour les connexions MongoDB ci-dessus.

    • DSN ODBC : sélectionnez le DSN ODBCAlteryxService créé précédemment.

  4. Sélectionnez Enregistrer, puis Informations d'identification Connect.

  5. Renseignez les champs suivants :

    • Méthode d'authentification : nom d'utilisateur et mot de passe MongoDB.

    • Informations d'identification : créez de nouvelles informations d'identification.

    • Nom des informations d'identification : nom de votre choix (par exemple, MongoDB_AlteryxService_Local).

    • Coffre-fort : DCM.

    • Nom d'utilisateur : utilisateur

    • Mot de passe : votre mot de passe.

    • Mécanisme d'authentification : SCRAM-SHA-256.

    • Source d'authentification : AlteryxService.

    • Autoriser la connexion pour SDK : décochée.

  6. Sélectionnez Tester la connexion. Si l'opération réussit, veuillez sélectionner Créer et lier.

  7. Répétez ces étapes pour la base de données AlteryxGallery.

Créer une connexion DCM avec l'API Server

  1. Ouvrez DCM. Dans Designer, accédez à Fichier > Gérer les connexions.

  2. Dans l'onglet Sources de données, sélectionnez + Nouveau et choisissez la vignette Télécharger.

    • Nom de la source de données : nom de votre choix (par exemple, API Server).

    • URL de base : saisissez l'URL de base de l'API Server. Elle se termine par /webapi/.

      Exemple : https://CompanyServerName/webapi/

  3. Sélectionnez Enregistrer.

  4. Sélectionnez Connecter les informations d'identification.

  5. Dans la liste déroulante Méthode d'authentification, sélectionnez Nom d'utilisateur et mot de passe.

  6. Dans la liste déroulante Identifiant, sélectionnez Créer un nouvel identifiant.

    • Nom des informations d'identification : nom de votre choix (par exemple, clés d'API Server).

    • Coffre-fort : sélectionnez DCM.

    • Nom d'utilisateur : saisissez la clé d'accès API, disponible dans votre profil Galerie.

    • Mot de passe : saisissez le secret d'accès à l'API, disponible dans votre profil Galerie.

  7. Sélectionnez Créer et lier.

(Facultatif) Créer des connexions DCM pour les bases de données de cache et de sortie

  1. Ouvrez DCM. Dans Designer, accédez à Fichier > Gérer les connexions.

  2. Sélectionnez + Nouveau et choisissez la vignette MongoDB.

  3. Dans la liste déroulante Technologie, sélectionnez la base de données souhaitée et terminez la configuration de votre connexion.

(Facultatif) Créer les tables nécessaires dans les bases de données de sortie.

Exécutez les applications suivantes afin de créer les tables requises dans les bases de données de sortie. Cette étape est facultative, selon vos préférences. Elle est également facultative si la base de données de cache n'est pas utilisée ou si les données ne sont pas envoyées vers des tables de base de données. Si l'un de ces usages s'applique, exécutez l'application correspondante.

  • Si vous utilisez une base de données pour mettre en cache les packages de workflow téléchargés depuis la Galerie, exécutez l'application Créer les tables de la base de données de cache (application).

  • Si vous utilisez une base de données pour écrire des données finales dans des tables, exécutez l'application Créer les tables de la base de données de sortie (application).

Exécuter le rapport d'utilisation d'Alteryx Server

Suivez ces étapes pour exécuter votre rapport d'utilisation de Server :

  1. Entrez les informations d'identification que vous avez créées lors des étapes précédentes :

    • Alteryx Gallery : connexion DCM à la base de données AlteryxGallery.

    • Alteryx Service : connexion DCM à la base de données AlteryxService.

    • Informations d'identification de l'API : connexion DCM aux informations d'identification de l'API Server.

    • Filtrer les tâches et les résultats par date : limite les requêtes des tables AS_Queue (tâches) et AS_Results (messages de résultats) afin de ne récupérer que les données antérieures à une date spécifiée.

    • Utiliser la base de données de workflow mise en cache (facultatif) : mettez en cache les téléchargements des packages d'applications à partir des appels API. Utilisez cette option si votre Designer contient de nombreux workflows, car le téléchargement peut être long à chaque exécution.

    • Sortie vers un fichier Tableau Hyper : définissez l'emplacement où vous souhaitez générer le fichier Tableau Hyper. Laissez la valeur par défaut lors du premier lancement pour tester le classeur Tableau.

    • Sortie vers des tables de base de données (facultatif) : utilisez la connexion DCM pour exporter les données dans des tables séparées dans votre propre base de données.

    • Sortie vers des fichiers séparés (facultatif) :

      • (Facultatif) Sélectionnez un emplacement (dossier) pour enregistrer les fichiers. Vide = dossier .\Output.

      • (Facultatif) Saisissez un préfixe. Vide = aucun préfixe.

      • Choisissez le type de fichier (CSV ou YXDB).

  2. Exécutez le workflow.

  3. Accédez au dossier sélectionné pour ouvrir le classeur Tableau et visualiser les données. Si le fichier Hyper a été généré dans un autre emplacement, reconnectez la source de données dans Tableau pour voir vos données.

Résolution des problèmes

Consultez cette section pour les problèmes courants et les étapes de résolution.

Vérifier les autorisations

Avant tout, assurez-vous que les bonnes autorisations sont définies dans l'interface utilisateur Alteryx Server pour télécharger les workflows :

  • Dans Server, accédez à Panneau administrateur > Paramètres > Ressources : assurez-vous que l'option Désactiver le téléchargement direct n'est pas sélectionnée.

  • Les utilisateurs doivent avoir coché la case D'autres personnes peuvent télécharger ce workflow dans les paramètres de chaque workflow. Cette option est activée par défaut, ainsi, sauf si l'utilisateur décoche explicitement cette case, le package de workflow devrait disposer des autorisations appropriées.

  • L'utilisateur exécutant le rapport d'utilisation de Server doit avoir l'accès API activé pour obtenir des jetons API.

Notes supplémentaires de résolution des problèmes

Consultez les erreurs courantes ainsi que les étapes de résolution proposées ci-dessous.

500 Not Found Response

Consultez cet article de la communauté.

Rapport d'utilisation d'Alteryx Server (8) : PullServiceDetails (1483) : Outil #147 : Erreur interne : tentative de lecture au-delà de la fin d'un blob.

Vérifiez les paramètres avancés du DSN ODBC. La taille de la colonne binaire doit être 2147483647.

Rapport d'utilisation d'Alteryx Server (8) : Échec de l'extraction des détails des workflows depuis Alteryx Server : Erreur de serveur interne HTTP/1.1 500

Vérifiez si le workflow est corrompu. Confirmez qu'il peut fonctionner sur Server.

Rapport d'utilisation d'Alteryx Server (8) : Échec de l'extraction des détails des workflows depuis Alteryx Server : HTTP/1.1 403 Interdit

Vérifiez que le workflow peut être téléchargé et que les paramètres globaux autorisent le téléchargement des workflows. Ensuite, vérifiez le paramètre « Désactiver le téléchargement direct » sous Admin > Paramètres dans Server.

HTTP/1.1 404 ou HTTP/1.1 401 ou « RetrieveServerOAuthToken : Échec du test DownloadSucceeded »

Vérifiez que le baseUrl de la connexion DCM est « http://localhost/webapi/ » (notez le suffixe /webapi ainsi que le « / » final ; n'utilisez pas /Gallery/ ici).

Veuillez vérifier que la clé d'accès (nom d'utilisateur) et le secret d'accès (mot de passe) de la connexion DCM sont corrects.

Vérifiez qu'AlteryxService est en cours d'exécution et que vous pouvez accéder à la Galerie ou à la documentation Swagger (API). Si ce n'est pas le cas, essayez de redémarrer AlteryxService dans Services.

Dans cette section​: