Utilisation de Performance Analytics avec des données externes

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 13 minutes de lecture

    • Analyse des performances sur les sources de données externes vous permet de réaliser une analyse détaillée sur des données qui ne se trouvent pas dans votre ServiceNow instance.

    Lorsque vous collectez les scores sur des données externes, Analyse des performances stocke les scores et les éléments de répartition à partir des données externes sur votre instance. Les données brutes analysées restent sur la source de données externe et ne sont pas copiées dans votre instance. Cette fonctionnalité vous permet d’analyser et de partager des mesures sans dupliquer les données sous-jacentes.

    La collecte de données externes d’Analyse des performances utilise trois types d’enregistrements de configuration :
    • Indicateur externe qui spécifie la source de données JDBC et l’instruction SQL utilisées pour collecter les scores.
    • Une répartition externe qui spécifie la source de données JDBC et l’instruction SQL utilisée pour spécifier les éléments de répartition.
    • Répartition d’indicateur externe qui définit la relation entre un indicateur externe et une répartition, ainsi que l’instruction SQL utilisée pour collecter les scores de chaque élément de répartition pour cet indicateur.

    Formats de base de données pris en charge pour les données externes

    Analyse des performances ne prend en charge que les formats de base de données pris ServiceNow en charge par défaut. Si un client ajoute un pilote JDBC pour un format de base de données non pris en charge, Analyse des performances il ne prend pas en charge ce format de base de données en tant que source de données externe.

    Tableau 1. Formats de base de données pris en charge
    Type de serveur SQL Port
    MySQL 3306
    Microsoft SQL Server 1433
    Oracle 1521

    Créer un indicateur pour les données externes

    Créez un indicateur externe pour définir les données à évaluer et l’instruction SQL utilisée pour déterminer le score de l’indicateur.

    Avant de commencer

    Rôle requis : pa_admin, pa_power_user ou admin

    Procédure

    1. Accédez à la Tout > Analyse des performances > Indicateurs externes et cliquez sur Nouveau.
    2. Donnez un nom descriptif à l’indicateur.
    3. Dans le champ Fréquence , spécifiez la fréquence des points de données de l’indicateur, par exemple Quotidienne, Hebdomadaire ou Mensuelle.
    4. Dans l’onglet Source , sélectionnez une source de données à partir de laquelle collecter des scores.
      Seules les sources de données de type JDBC sont prises en charge par Analyse des performances. Consultez la documentation sur les sources de données pour plus d’informations sur la configuration des sources de données.
      Remarque :
      L’instruction SQL et la table de jeux d’importation définies dans la source de données ne sont pas utilisées par Analyse des performances.
    5. Spécifiez l’instruction SQL à utiliser pour calculer la valeur du score.
      L’instruction SQL doit renvoyer une valeur agrégée avec l’alias valueet doit filtrer les données en fonction d’un champ de date.
      Important :
      L’alias d’agrégat doit être une valeur.
      Pour un indicateur simple, l’instruction SQL sera quelque chose comme SELECT count(*) AS value FROM... OÙ DATE(date_field) >= DATE(${start_at}).

      Pour les indicateurs plus complexes, vous pouvez également avoir besoin d’une condition selon laquelle DATE est antérieur à la date renvoyée par DATEADD. Ici, un indicateur mensuel avec des données complexes a l’instruction SQL SELECT count(*) AS value FROM... OÙ DATE(date_field) >= DATE(${start_at}) ET DATE(date_field) < DATEADD(mois, 1, ${start_at}).

    6. Si vous préférez que le score de cet indicateur augmente ou diminue avec le temps, sélectionnez Agrandir ou Réduire dans le champ Direction .
      Les outils d’analyse et les affichages graphiques utilisent cette direction avec cet indicateur.
      Conseil :
      Fixez une direction chaque fois que vous le pouvez. Tous les indicateurs clés doivent être définis sur Maximiser ou Minimiser.
      ValeurCas d'utilisation
      Agrandir Sélectionnez si une augmentation du score de cet indicateur est souhaitée. Par exemple, envisagez de sélectionner Maximiser pour un indicateur qui indique le chiffre d’affaires. Les outils d’analyse et les éléments graphiques montrent qu’une augmentation de ce score d’indicateur est bonne et qu’une diminution est mauvaise.
      Réduire Sélectionnez si une diminution de ce score d’indicateur est souhaitée. Par exemple, envisagez de sélectionner Réduire pour un indicateur qui affiche les coûts. Les outils d’analyse et les éléments graphiques indiquent qu’une diminution de ce score d’indicateur est bonne et qu’une augmentation est mauvaise.
      Néant Sélectionnez si la direction du changement de ce score n’a pas d’importance pour votre entreprise.
    7. Facultatif : Spécifiez l’une de ces propriétés d’indicateur :
      Champ Description
      Unité Unité de mesure du score, telle que le nombre, les jours ou les pourcentages.

      Pour collecter les scores dans la devise de référence du système sur un champ Prix, Devise ou Devise FX, sélectionnez Utiliser la devise de référence. Pour plus d'informations, consultez Scores des indicateurs dans la devise de référence.

      Si vous sélectionnez % ou une période comme unité, envisagez d’exclure certains types de séries chronologiques de l’application à l’indicateur. Pour plus d'informations, consultez Exclure les séries chronologiques d’un indicateur.

      Si vous sélectionnez l’unité Heure, la durée est indiquée sous forme de Jours, Heures et Minutes. Si la propriété glide.ui.duration.seconds.enabled système existe et a la valeur vrai, les secondes s’affichent également. Dans ce cas, les secondes sont également affichées pour tous les champs de temps sur l’instance et sont incluses dans les exportations vers Microsoft Excel.
      Précision Nombre de chiffres après le séparateur décimal. Pour plus d'informations, consultez Arrondi et précision des indicateurs.

      Ce champ n’est pas disponible lorsque l’unité est Utiliser la devise de référence. Dans ce cas, la précision est héritée de la devise de référence.
      Format de nombre Abréviations utilisées pour les grands nombres, des milliers aux quintillions. Pour plus d'informations, consultez Arrondi et précision des indicateurs.
      Clé Identifie l’indicateur comme indicateur clé. Utilisé uniquement pour filtrer la liste des indicateurs dans Analyse des performances > Centre d'analyse. Non utilisé dans l’expérience Platform Analytics .
    8. Dans l’onglet Contrôle d’accès , indiquez si cet indicateur doit être enregistré dans la bibliothèque et s’il faut limiter la visibilité de l’indicateur par utilisateur, groupe ou rôle.
      L’activation de Partager vers la bibliothèque signifie que l’indicateur sera disponible aux emplacements suivants :
      • Liste des KPI dans la bibliothèque d’expériences Platform Analytics
      • Détails des KPI
      • Centre d'analyse, mais uniquement sur les instances mises à niveau qui n’ont pas encore été entièrement migrées vers Platform Analytics
    9. Facultatif : Dans l’onglet Autre , définissez diverses propriétés diverses.
      Tableau 2. Champs de l’onglet 'Autre'
      Champ Description
      Séries chronologiques par défaut

      Fonction analytique prédéfinie, telle qu’une moyenne sur 7 jours, à appliquer à l’indicateur au lieu d’afficher les scores bruts de l’indicateur.

      Pour plus d'informations, consultez Application d'agrégations de séries chronologiques.
      Remarque :
      Vous ne pouvez pas définir les séries chronologiques par défaut pour un indicateur qui utilise un calendrier d’entreprise ou fiscal. Ces calendriers ne prennent pas en charge les agrégations de séries chronologiques.
      Profil de groupe actif

      Enregistrement de profil de groupe actif [live_group_profile] pour un groupe Flux en direct. Spécifiez un profil de groupe pour que ce groupe reçoive des notifications sur cet indicateur.

      Pour en savoir plus sur cette application de réseau social dans , Now Platformvoir Flux en direct.
      Commande

      Numéro indiquant l’ordre dans lequel les indicateurs sont affichés dans le Centre d'analyse. Les indicateurs dont la valeur est la plus faible sont affichés en haut de la liste. Si aucune valeur n’est fournie dans le champ Commande , les indicateurs s’affichent de a à z à l’aide du champ Nom . Pour utiliser le champ Ordre, vous devez saisir des numéros d’ordre pour tous les indicateurs. Si vous entrez des chiffres pour seulement quelques indicateurs, l’ordre dans lequel les indicateurs sont affichés revient à a à z.

      Non utilisé dans l’expérience Platform Analytics .
      Type de graphique par défaut

      Définissez un type de graphique par défaut (ligne, colonne, spline ou aire) pour cet indicateur. Lorsque vous ouvrez le Centre d'analyse ou Détails des KPI pour cet indicateur pour la première fois, le type de graphique par défaut est utilisé. Si le type de graphique est modifié dans le Centre d'analyse ou Détails des KPI, cette préférence est mémorisée.
      Afficher des lignes continues

      Lorsque cette option est sélectionnée, les et Détails des KPI affichent des Centre d'analyse lignes de données ininterrompues pour cet indicateur, même lorsqu’il n’y a aucune donnée pour une date spécifique. Ce comportement peut être utile lors de l’affichage d’ensembles de données avec des dates de début variées ou pour des données qui ne sont pas régulièrement mises à jour, telles que des informations de stock.

      Les lignes continues ne sont pas rendues lorsqu’une série chronologique est définie sur l’indicateur ou le Centre d'analyse ou Détails des KPI.
      Afficher le score en temps réel

      Lorsque cette option est sélectionnée, le Centre d'analyse et Détails des KPI peut afficher le score de cet indicateur en temps réel, ainsi que l’état actuel des enregistrements associés. Décochez cette case lorsque les données de l’indicateur ne sont pas disponibles en temps réel, par exemple dans une intégration qui utilise des données provenant d’une source tierce. Pour plus d'informations, consultez Scores en temps réel.

      Remarque : Une condition doit être définie sur l’indicateur ou la source d’indicateur associée pour que les scores en temps réel s’affichent.
      Par exemple, dans l’onglet Autre, vous pouvez configurer un indicateur comme suit :
      • Par défaut, il affiche une somme de scores en cours sur 30 jours dans les widgets. Vous pouvez remplacer cette valeur par défaut dans les , , widgets de tableau de bord ou visualisation des données de l’espace Centre d'analyseDétails des KPIde travail.
      • Le groupe IT en direct est informé des changements apportés à l’indicateur.
      • L’indicateur figure en troisième position dans la Centre d'analyse liste des indicateurs. La position de tous les autres indicateurs est également spécifiée. Ce paramètre n’affecte pas l’ordre des indicateurs sur Détails des KPI.
      • Le type de graphique par défaut est Spline sur le Centre d'analyse et Détails des KPI.
      • Les lignes de données de l’indicateur sont affichées sans interruption, même lorsque des données sont manquantes.
      • Le Centre d'analyse et Détails des KPI peut afficher le score de cet indicateur en temps réel.

      L’onglet Autre d’un indicateur avec les paramètres énumérés précédemment

    10. Facultatif : Dans l’onglet Prévision , définissez la méthode de prévision, le nombre de périodes de collecte de données à prévoir, la quantité de données historiques sur laquelle baser la prévision et les limites supérieure et inférieure des valeurs de prévision.
      Pour plus d'informations, consultez Prévisions des scores d’Analyse des performances.
    11. Enregistrez l’indicateur.
    12. Appuyez sur Collection de tests.
      Cette action teste la requête principale de l’indicateur.

    Que faire ensuite

    Si vous souhaitez collecter les scores de répartition pour l’indicateur, définissez une répartition externe et associez-la à l’indicateur.

    Créer une répartition à l’aide de données externes

    Créez une répartition externe pour définir les éléments disponibles afin de répartir les scores des indicateurs externes.

    Avant de commencer

    Rôle requis : pa_admin, pa_power_user ou admin

    Pourquoi et quand exécuter cette tâche

    Par défaut, une répartition externe peut contenir un maximum de 5 000 éléments. Cette limite est contrôlée par la propriété com.snc.pa.dc.max_external_elements.

    Les éléments de répartition externes sont stockés dans les tables pa_ext_elements.

    Procédure

    1. Accédez à la Tout > Analyse des performances > Répartitions externes.
    2. Cliquez sur Nouveau.
    3. Sélectionnez une source de données qui contient les enregistrements que vous souhaitez utiliser comme éléments de répartition.
      Seules les sources de données de type JDBC sont prises en charge par Analyse des performances. Consultez la documentation sur les sources de données pour plus d’informations sur la configuration des sources de données.
      Remarque :
      L’instruction SQL et la table de jeux d’importation définies dans la source de données ne sont pas utilisées par Analyse des performances.
    4. Spécifiez une instruction SQL pour sélectionner les éléments de répartition.
      L’instruction SQL doit renvoyer la clé unique pour chaque élément de répartition avec l’alias id et le nom d’affichage de l’élément avec l’alias name, tel que SELECT GUID AS id, user_name AS name FROM....
      Important :
      L’alias de clé unique doit être l’ID et l’alias du nom d’affichage doit être le nom.
    5. Enregistrez la répartition.
    6. Appuyez sur Collection de tests.
      Cette action teste la requête qui sélectionne les éléments de répartition.

    Que faire ensuite

    Après avoir défini comment collecter des éléments de répartition, associez la répartition externe à un ou plusieurs indicateurs externes.

    Configurer un indicateur externe pour utiliser une répartition externe

    Associez un indicateur externe et une répartition externe pour définir comment collecter les scores de répartition pour l’indicateur.

    Avant de commencer

    Rôle requis : pa_admin, pa_power_user ou admin

    Procédure

    1. Accédez à la Tout > Analyse des performances > Indicateurs externes.
    2. Sélectionnez un indicateur.
    3. Dans la liste connexe Répartitions , cliquez sur Nouveau.
    4. Sélectionnez la répartition externe à appliquer à cet indicateur.
    5. Dans le champ Instruction SQL , entrez une instruction SQL qui calcule la valeur du score pour chaque élément de répartition.
      L’instruction SQL doit utiliser la même fonction d’agrégat que l’instruction SQL de l’indicateur, telle que COUNT. L’instruction SQL doit renvoyer la valeur agrégée avec l’alias value et la clé unique de l’élément de répartition avec l’ID d’alias. L’instruction SQL doit également regrouper les données par colonne qui contient les valeurs de l’élément de répartition.
      Par exemple, SELECT count(*) AS value, guid as id FROM... OÙ DATE(date_field) >= DATE({$start_at}) GROUPE PAR GUID
      Important :
      L’alias d’agrégat doit être une valeur et l’alias de clé unique de répartition doit être id.
    6. Enregistrez vos changements.
    7. Appuyez sur Collection de tests.
      Cette action teste l’instruction SQL qui calcule la valeur de score pour l’élément de répartition.

    Que faire ensuite

    Répétez les étapes précédentes pour ajouter des répartitions supplémentaires à l’indicateur. Testez l’instruction SQL après avoir ajouté chacune d’elles.

    Tester les indicateurs externes et les répartitions

    Testez vos indicateurs externes et vos répartitions pour vous assurer que vous pouvez vous connecter à la source de données externe et collecter les données que vous attendez.

    Avant de commencer

    Rôle requis : pa_admin, pa_power_user ou admin

    Pourquoi et quand exécuter cette tâche

    Testez un indicateur pour tester la requête de cet indicateur et les requêtes de tous les éléments de répartition. Tester une répartition pour tester la requête utilisée pour déterminer les éléments de répartition disponibles.

    Aucun score ou élément de répartition n’est enregistré lorsque vous testez un indicateur ou une répartition.

    Procédure

    1. Accédez à la Tout > Analyse des performances > Indicateurs externes ou Analyse des performances > Répartitions externes.
    2. Sélectionnez l’indicateur ou la répartition que vous souhaitez tester.
    3. Cliquez sur le bouton Test .
      Si la requête s’exécute avec succès, le nombre de scores ou d’éléments de répartition qui seraient collectés s’affiche. Si une erreur se produit pendant le test, le message d’erreur s’affiche.

    Que faire ensuite

    Après avoir vérifié que toutes les requêtes s’exécutent correctement et renvoient les données attendues, ajoutez l’indicateur externe à un travail de collecte de données pour commencer à collecter des scores.

    Filtrage des données externes par date

    Lorsque vous utilisez Analyse des performances avec des données externes, vous devez filtrer les instructions SQL qui collectent les scores par date.

    Dans les instructions SQL d’indicateur et de répartition d’indicateur, filtrez la requête par date, par exemple WHERE DATE(my_date_field) >= DATE(${start_at}). Il n’est pas nécessaire de filtrer les instructions SQL de répartition par date car les instructions SQL de répartition ne collectent que des éléments et non des scores.

    La variable ${start_at} contient la date de la période collectée au format AAAAMMJJ. Pour les indicateurs quotidiens, cette valeur correspond toujours à la date collectée. Pour les indicateurs dont la fréquence de collecte est plus longue, par exemple hebdomadaire ou mensuelle, la date est le premier jour de la période de collecte. La date d’exécution de la tâche de collecte de données n’affecte pas cette variable.

    Lorsque vous testez un indicateur ou une répartition, la variable ${start_at} est toujours définie sur la date actuelle.

    Limitations lors de l’utilisation de Performance Analytics avec des données externes

    Certaines fonctionnalités d’Analyse des performances ne sont pas disponibles lorsque vous mesurez des données externes.

    • Vous ne pouvez pas collecter d’instantanés
    • Vous ne pouvez pas afficher les scores en temps réel
    • Vous ne pouvez pas appliquer de répartitions de niveau 2
    • Vous ne pouvez pas utiliser les visualisations de widget qui dépendent de répartitions de niveau 2 avec des données externes. Cela inclut les visualisations de tableaux croisés dynamiques et de cartes thermiques.
    • Étant donné que les instantanés ne sont pas disponibles, vous ne pouvez pas afficher les changements dans les enregistrements collectés