Utilisation de Performance Analytics avec des données externes

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

Lorsque vous collectez des scores sur des données externes, Performance Analytics 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 dans 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.
• Une répartition d’indicateur externe qui définit la relation entre un indicateur externe et une répartition, et l’instruction SQL utilisée pour collecter les scores pour 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 prend en charge uniquement 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 ce format de base de données ne prend pas en charge 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 les 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 en savoir plus 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 d’agrégat avec l’alias valueet 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érieure à 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 dans 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 Agrandir pour un indicateur qui affiche le chiffre d’affaires. Les outils d’analyse et les éléments graphiques reflètent le fait 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 reflètent le fait 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 nombre, jours ou pourcentages. Pour collecter les scores dans la devise de référence du système dans 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é, l’heure est indiquée sous forme de jours, d’heures et de minutes. Si la propriété glide.ui.duration.seconds.enabled système existe et qu’elle 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	Nombre de chiffres derrière le séparateur décimal. Pour plus d'informations, consultez Arrondi et précision dans les 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	Les abréviations utilisées pour les grands nombres, des milliers aux trillions. Pour plus d'informations, consultez Arrondi et précision dans les 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 , définissez s’il faut enregistrer cet indicateur dans la bibliothèque et si vous souhaitez limiter la visibilité de l’indicateur par utilisateur, groupe ou rôle.
   L’activation de Partager avec la bibliothèque signifie que l’indicateur sera disponible aux emplacements suivants :

   • La 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 entièrement migré vers Platform Analytics
9. Facultatif : Dans l’onglet Autre , définissez diverses propriétés diverses.

   Tableau 2. Champs de l’onglet « Autres »

   Champ	Description
   Séries chronologiques par défaut	Fonction analytique prédéfinie, telle qu’une moyenne d’exécution 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 d’un 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 au sujet de cet indicateur. Pour plus d’informations sur cette application sociale dans la Now Platformsection Flux en direct.
   Commande	Nombre indiquant l’ordre dans lequel les indicateurs sont affichés dans le Centre d'analysefichier . 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 Ordre , les indicateurs s’affichent de a à z dans le champ Nom . Pour utiliser le champ Ordre, vous devez saisir les numéros d’ordre de tous les indicateurs. Si vous entrez des nombres pour quelques indicateurs seulement, 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 zone) pour cet indicateur. Lors de l’ouverture du ou Détails des KPI pour cet Centre d'analyse 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 Centre d'analyse et Détails des KPI affichent 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 de jeux de données avec des dates de démarrage variées 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 le Centre d'analyse .Détails des KPI
   Afficher le score en temps réel	Lorsqu’il est sélectionné, 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 de 30 jours consécutifs dans les widgets. Vous pouvez remplacer cette valeur par défaut dans les widgets du tableau de bord , Détails des KPIou dans la visualisation des données de l’espace de Centre d'analysetravail.
   • Le groupe opérationnel informatique est informé des changements apportés à l’indicateur.
   • L’indicateur est classé troisième 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 et Détails des KPI.Centre d'analyse
   • Les lignes de données de l’indicateur sont affichées intactes, 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 lesquelles 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 Test Collection.
    Cette action teste la requête principale de l’indicateur.

Que faire ensuite

Si vous souhaitez collecter des 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 5000 é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 en savoir plus 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 retourner 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 id et l’alias de nom d’affichage doit être name.
5. Enregistrez la répartition.
6. Appuyez sur 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 la manière de 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 manière 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 de l’instruction SQL , saisissez 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 de l’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 selon la 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}) GROUPER PAR GUID

   Important :

   L’alias d’agrégat doit être value et l’alias de clé unique de répartition doit être id.
6. Enregistrez vos changements.
7. Appuyez sur Test Collection.
   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 l’ajout de chacune d’entre elles.

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 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 pour 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 apparaît. 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 avec succès et renvoient les données attendues, ajoutez l’indicateur externe à une tâche de collecte de données pour commencer à collecter des scores.

Filtrage des données externes par date

Lorsque vous utilisez Performance Analytics 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 journaliers, cette valeur correspond toujours à la date de collecte. 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 des répartitions de niveau 2
• Vous ne pouvez pas utiliser des visualisations de widgets qui dépendent de répartitions de niveau 2 avec des données externes. Cela inclut les visualisations sous forme de tableau croisé dynamique et de carte thermique.
• Étant donné que les instantanés ne sont pas disponibles, vous ne pouvez pas afficher les changements dans les enregistrements collectés