Utilisation de Performance Analytics avec des données externes

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 des 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 sur 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 de cet indicateur.

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

Analyse des performances prend uniquement en charge 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

Information associée

• Source de données de type JDBC

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 des ensembles de données à importer 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 d’agrégat 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 indiquant que 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(month, 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 :

   Définissez une direction chaque fois que vous le pouvez. Tous les indicateurs clés doivent être définis sur Maximiser ou Minimiser.

   Valeur	Cas d'utilisation
   Agrandir	Sélectionnez si une augmentation de ce score d’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 Minimiser pour un indicateur qui affiche les coûts. Les outils d’analyse et les éléments graphiques montrent qu’une diminution de ce score d’indicateur est bonne et qu’une augmentation est mauvaise.
   Aucun	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’heure comme unité, les heures sont exprimées sous forme de jours, d’heures et de minutes. Si la propriété glide.ui.duration.seconds.enabled système existe et est vraie, 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	Le 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 trillions. Pour plus d'informations, consultez Arrondi et précision des indicateurs.
   Clé	Identifie l’indicateur comme un 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 s’il faut enregistrer cet indicateur dans la bibliothèque et s’il faut limiter la visibilité de l’indicateur par utilisateur, groupe ou rôle.
   L’activation de l’option Partager dans 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 Other (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 glissante 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 d’un indicateur qui utilise un calendrier commercial 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 sociale, consultez la ServiceNow AI Platform rubrique Flux en direct.
   Ordre	Nombre indiquant l’ordre dans lequel les indicateurs sont affichés dans le Centre d'analyse. Les indicateurs avec la valeur 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 dans le champ Nom . Pour utiliser le champ Commande, vous devez saisir des numéros de commande pour tous les indicateurs. Si vous entrez des chiffres pour seulement quelques indicateurs, l’ordre dans lequel les indicateurs sont affichés revient de 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 ou Centre d'analyseDé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, le Centre d'analyse et Détails des KPI affiche des lignes de données ininterrompues pour cet indicateur, même en l’absence de données 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 variables ou pour des données qui ne sont pas régulièrement mises à jour, telles que les informations de stock. Les lignes continues ne sont pas rendues lorsqu’une série chronologique est définie sur l’indicateur ou sur 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, comme 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 soient affichés.

   Par exemple, dans l’onglet Autre, vous pouvez configurer un indicateur comme suit :

   • Par défaut, il affiche une somme cumulée des scores sur 30 jours dans les widgets. Vous pouvez remplacer cette valeur par défaut dans les , , les widgets du tableau de bord ou la visualisation des données de l’espace Centre d'analyseDétails des KPI de travail.
   • Le groupe IT Live est informé des changements apportés à l’indicateur.
   • L’indicateur est répertorié 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 ininterrompues, 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.

   

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. Press Test Collection.
    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 pour 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 des ensembles de données à importer 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 de 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 ID et l’alias du nom d’affichage doit être nom.
5. Enregistrez la répartition.
6. Press Test Collection.
   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 les é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 la façon de 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 de score pour chaque élément de répartition.
   L’instruction SQL doit utiliser la même fonction d’agrégat que l’instruction SQL d’indicateur, telle que COUNT. L’instruction SQL doit renvoyer la valeur d’agrégat 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 la colonne qui contient les valeurs des éléments de répartition.

   Par exemple, SELECT count(*) AS value, guid as id FROM... WHERE DATE(date_field) >= DATE({$start_at}) GROUP BY 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. Press Test Collection.
   Cette action teste l’instruction SQL qui calcule la valeur de score de 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 l’avoir ajoutée.

Tester les indicateurs externes et les répartitions

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

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 pour tous les éléments de répartition. Testez 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 confirmé que toutes les requêtes s’exécutent correctement et renvoient les données attendues, ajoutez l’indicateur externe à une tâche de collecte de données pour commencer à collecter des scores.

Filtrer les 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 collectent uniquement 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 de collecte. Pour les indicateurs avec des fréquences de collecte plus longues, telles que hebdomadaire ou mensuelle, la date est le premier jour de la période de collecte. La date à laquelle la tâche de collecte de données s’exécute 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 d’Analyse des performances 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 de visualisations de widgets 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