Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # ServiceNow MetricBase Connecteur d'intégration **Avertissement** Ce connecteur est passé à la *phase de durée de vie prolongée* et AWS IoT Greengrass ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations aux fonctionnalités existantes, des correctifs de sécurité ou des corrections de bogues. Pour de plus amples informations, veuillez consulter [AWS IoT Greengrass Version 1 politique de maintenance](maintenance-policy.md). Le [connecteur ServiceNow MetricBase ](connectors.md) d'intégration publie les statistiques des séries chronologiques des appareils Greengrass vers. ServiceNow MetricBase Cela vous permet de stocker, analyser et visualiser les données en séries chronologiques à partir de l'environnement Greengrass Core et d'agir sur les événements locaux. Ce connecteur reçoit des séries chronologiques sur un sujet MQTT et publie les données sur l' ServiceNow API à intervalles réguliers. Vous pouvez utiliser ce connecteur pour prendre en charge des scénarios, tels que : + Créer des alertes basées sur le seuil et des alarmes en fonction des données en séries chronologiques collectées depuis les appareils Greengrass. + Utilisez les données des services temporels des appareils Greengrass avec des applications personnalisées créées sur la ServiceNow plateforme. Ce connecteur possède les versions suivantes. | Version | ARN | | --- | --- | | 4 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/4` | | 3 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/3` | | 2 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/2` | | 1 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/1` | Pour obtenir des informations sur les changements apportés aux versions, veuillez consulter le [Journal des modifications](#servicenow-connector-changelog). ## Prérequis Ce connecteur possède les critères suivants : ------ #### [ Version 3 - 4 ] + AWS IoT Greengrass Logiciel de base v1.9.3 ou version ultérieure. AWS IoT Greengrass doit être configuré pour prendre en charge les secrets locaux, comme décrit dans la section [Exigences relatives aux secrets](secrets.md#secrets-reqs). **Note** Cette exigence inclut l'autorisation d'accéder aux secrets de votre Gestionnaire de Secrets. *Si vous utilisez le rôle de service Greengrass par défaut, Greengrass est autorisé à obtenir les valeurs des secrets dont le nom commence par greengrass-.* + [Python](https://www.python.org/) version 3.7 ou 3.8 installé sur le périphérique principal et ajouté à la variable d'environnement PATH. **Note** Pour utiliser Python 3.8, exécutez la commande suivante pour créer un lien symbolique entre le dossier d'installation par défaut de Python 3.7 et les fichiers binaires Python 3.8 installés. ``` sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7 ``` Ceci configure votre appareil de sorte qu'il réponde aux exigence de Python pour AWS IoT Greengrass. + Un ServiceNow compte avec un abonnement activé à MetricBase. En outre, une métrique et une table de métriques doivent être créées dans le compte. Pour plus d'informations, consultez [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)la ServiceNow documentation. + Secret de type texte AWS Secrets Manager qui stocke le nom d'utilisateur et le mot de passe permettant de se connecter à votre ServiceNow instance avec une authentification de base. Le secret doit contenir les clés « utilisateur » et « mot de passe » avec des valeurs correspondantes. Pour plus d'informations, consultez la section [Création d'un secret de base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dans le *guide de AWS Secrets Manager l'utilisateur*. + Une ressource secrète du groupe Greengrass qui fait référence au secret du Secrets Manager. Pour de plus amples informations, veuillez consulter [Déployez les secrets jusqu'au AWS IoT Greengrass cœur](secrets.md). ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Logiciel principal v1.7 ou version ultérieure. AWS IoT Greengrass doit être configuré pour prendre en charge les secrets locaux, comme décrit dans la section [Exigences relatives aux secrets](secrets.md#secrets-reqs). **Note** Cette exigence inclut l'autorisation d'accéder aux secrets de votre Gestionnaire de Secrets. *Si vous utilisez le rôle de service Greengrass par défaut, Greengrass est autorisé à obtenir les valeurs des secrets dont le nom commence par greengrass-.* + [Python](https://www.python.org/) version 2.7 installé sur le périphérique principal et ajouté à la variable d'environnement PATH. + Un ServiceNow compte avec un abonnement activé à MetricBase. En outre, une métrique et une table de métriques doivent être créées dans le compte. Pour plus d'informations, consultez [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)la ServiceNow documentation. + Secret de type texte AWS Secrets Manager qui stocke le nom d'utilisateur et le mot de passe permettant de se connecter à votre ServiceNow instance avec une authentification de base. Le secret doit contenir les clés « utilisateur » et « mot de passe » avec des valeurs correspondantes. Pour plus d'informations, consultez la section [Création d'un secret de base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dans le *guide de AWS Secrets Manager l'utilisateur*. + Une ressource secrète du groupe Greengrass qui fait référence au secret du Secrets Manager. Pour de plus amples informations, veuillez consulter [Déployez les secrets jusqu'au AWS IoT Greengrass cœur](secrets.md). ------ ## Paramètres du connecteur Ce connecteur fournit les paramètres suivants : ------ #### [ Version 4 ] `PublishInterval` Le nombre maximal de secondes à attendre entre la publication d'événements sur ServiceNow. La valeur maximale est 900. Le connecteur publie à la ServiceNow date à laquelle `PublishBatchSize` il est atteint ou `PublishInterval` expire. Nom affiché dans la AWS IoT console : **Intervalle de publication en secondes** Nécessaire : `true` Type : `string` Valeurs valides : `1 - 900` Modèle valide : `[1-9]|[1-9]\d|[1-9]\d\d|900` `PublishBatchSize` Le nombre maximum de valeurs métriques pouvant être regroupées par lots avant leur publication sur ServiceNow. Le connecteur publie à la ServiceNow date à laquelle `PublishBatchSize` il est atteint ou `PublishInterval` expire. Nom affiché dans la AWS IoT console : **Taille du lot de publication** Nécessaire : `true` Type : `string` Modèle valide : `^[0-9]+$` `InstanceName` Nom de l'instance à laquelle se connecter ServiceNow. Nom affiché dans la AWS IoT console : **Nom de l' ServiceNow instance** Nécessaire : `true` Type : `string` Modèle valide : `.+` `DefaultTableName` Nom de la table contenant les informations `GlideRecord` associées à la base de MetricBase données de séries chronologiques. La propriété `table` de la charge utile du message d'entrée peut être utilisée pour remplacer cette valeur. Nom affiché dans la AWS IoT console : **nom de la table devant contenir la métrique** Nécessaire : `true` Type : `string` Modèle valide : `.+` `MaxMetricsToRetain` Nombre maximal de métriques à enregistrer dans la mémoire avant qu'elles ne soient remplacées par de nouvelles métriques. Cette limite s'applique lorsqu'il n'y a aucune connexion à Internet et que le connecteur démarre pour mettre en tampon les métriques à publier ultérieurement. Lorsque le tampon est plein, les métriques les plus anciennes sont remplacées par de nouvelles métriques. Les métriques ne sont pas enregistrées si le processus hôte du connecteur est interrompu. Par exemple, cela peut se produire pendant le déploiement du groupe ou lorsque le périphérique redémarre. Cette valeur doit être supérieure à la taille du lot et suffisamment grande pour contenir les messages basés sur le taux entrant des messages MQTT. Nom affiché dans la AWS IoT console : **nombre maximal de mesures à conserver en mémoire** Nécessaire : `true` Type : `string` Modèle valide : `^[0-9]+$` `AuthSecretArn` Le secret AWS Secrets Manager qui contient le nom ServiceNow d'utilisateur et le mot de passe. Il doit s'agir d'un secret de type texte. Le secret doit contenir les clés « utilisateur » et « mot de passe » avec des valeurs correspondantes. Nom affiché dans la AWS IoT console : **ARN du secret d'authentification** Nécessaire : `true` Type : `string` Modèle valide : `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+` `AuthSecretArn-ResourceId` La ressource secrète du groupe qui fait référence au secret de Secrets Manager pour les ServiceNow informations d'identification. Nom affiché dans la AWS IoT console : ressource de **jeton d'authentification** Nécessaire : `true` Type : `string` Modèle valide : `.+` `IsolationMode` Mode [conteneurisation](connectors.md#connector-containerization) de ce connecteur. La valeur par défaut est`GreengrassContainer`, ce qui signifie que le connecteur s'exécute dans un environnement d'exécution isolé à l'intérieur du AWS IoT Greengrass conteneur. Le paramètre de conteneurisation par défaut pour le groupe ne s'applique pas aux connecteurs. Nom affiché dans la AWS IoT console : **mode d'isolation du conteneur** Nécessaire : `false` Type : `string` Valeurs valides : `GreengrassContainer` ou `NoContainer` Modèle valide : `^NoContainer$|^GreengrassContainer$` ------ #### [ Version 1 - 3 ] `PublishInterval` Le nombre maximal de secondes à attendre entre la publication d'événements sur ServiceNow. La valeur maximale est 900. Le connecteur publie à la ServiceNow date à laquelle `PublishBatchSize` il est atteint ou `PublishInterval` expire. Nom affiché dans la AWS IoT console : **Intervalle de publication en secondes** Nécessaire : `true` Type : `string` Valeurs valides : `1 - 900` Modèle valide : `[1-9]|[1-9]\d|[1-9]\d\d|900` `PublishBatchSize` Le nombre maximum de valeurs métriques pouvant être regroupées par lots avant leur publication sur ServiceNow. Le connecteur publie à la ServiceNow date à laquelle `PublishBatchSize` il est atteint ou `PublishInterval` expire. Nom affiché dans la AWS IoT console : **Taille du lot de publication** Nécessaire : `true` Type : `string` Modèle valide : `^[0-9]+$` `InstanceName` Nom de l'instance à laquelle se connecter ServiceNow. Nom affiché dans la AWS IoT console : **Nom de l' ServiceNow instance** Nécessaire : `true` Type : `string` Modèle valide : `.+` `DefaultTableName` Nom de la table contenant les informations `GlideRecord` associées à la base de MetricBase données de séries chronologiques. La propriété `table` de la charge utile du message d'entrée peut être utilisée pour remplacer cette valeur. Nom affiché dans la AWS IoT console : **nom de la table devant contenir la métrique** Nécessaire : `true` Type : `string` Modèle valide : `.+` `MaxMetricsToRetain` Nombre maximal de métriques à enregistrer dans la mémoire avant qu'elles ne soient remplacées par de nouvelles métriques. Cette limite s'applique lorsqu'il n'y a aucune connexion à Internet et que le connecteur démarre pour mettre en tampon les métriques à publier ultérieurement. Lorsque le tampon est plein, les métriques les plus anciennes sont remplacées par de nouvelles métriques. Les métriques ne sont pas enregistrées si le processus hôte du connecteur est interrompu. Par exemple, cela peut se produire pendant le déploiement du groupe ou lorsque le périphérique redémarre. Cette valeur doit être supérieure à la taille du lot et suffisamment grande pour contenir les messages basés sur le taux entrant des messages MQTT. Nom affiché dans la AWS IoT console : **nombre maximal de mesures à conserver en mémoire** Nécessaire : `true` Type : `string` Modèle valide : `^[0-9]+$` `AuthSecretArn` Le secret AWS Secrets Manager qui contient le nom ServiceNow d'utilisateur et le mot de passe. Il doit s'agir d'un secret de type texte. Le secret doit contenir les clés « utilisateur » et « mot de passe » avec des valeurs correspondantes. Nom affiché dans la AWS IoT console : **ARN du secret d'authentification** Nécessaire : `true` Type : `string` Modèle valide : `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+` `AuthSecretArn-ResourceId` La ressource secrète du groupe qui fait référence au secret de Secrets Manager pour les ServiceNow informations d'identification. Nom affiché dans la AWS IoT console : ressource de **jeton d'authentification** Nécessaire : `true` Type : `string` Modèle valide : `.+` ------ ### Exemple de création de connecteur (AWS CLI) La commande CLI suivante crée un `ConnectorDefinition` avec une version initiale contenant le connecteur ServiceNow MetricBase d'intégration. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyServiceNowMetricBaseIntegrationConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/4", "Parameters": { "PublishInterval" : "10", "PublishBatchSize" : "50", "InstanceName" : "myinstance", "DefaultTableName" : "u_greengrass_app", "MaxMetricsToRetain" : "20000", "AuthSecretArn" : "arn:aws:secretsmanager:region:account-id:secret:greengrass-secret-hash", "AuthSecretArn-ResourceId" : "MySecretResource", "IsolationMode" : "GreengrassContainer" } } ] }' ``` **Note** La fonction Lambda de ce connecteur a un cycle de [vie](lambda-functions.md#lambda-lifecycle) prolongé. Dans la AWS IoT Greengrass console, vous pouvez ajouter un connecteur depuis la page **Connecteurs** du groupe. Pour de plus amples informations, veuillez consulter [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md). ## Données d'entrée Ce connecteur accepte les métriques de séries chronologiques sur un sujet MQTT et les publie sur. ServiceNow Les messages d'entrée doivent être au format JSON. **Filtre de rubrique dans l'abonnement** `servicenow/metricbase/metric` **Propriétés des messages** `request` Informations sur la table, l'enregistrement et la métrique. Cette requête représente l'objet `seriesRef` dans une demande POST en séries chronologiques. Pour plus d'informations, consultez [ Clotho Time Series API - POST](https://docs.servicenow.com/bundle/london-application-development/page/integrate/inbound-rest/concept/Clotho-Time-Series-API.html#clotho-POST-put). Nécessaire : `true` Type : `object` qui inclut les propriétés suivantes : `subject` `sys_id` de l'enregistrement spécifique dans la table. Nécessaire : `true` Type : `string` `metric_name` Nom du champ de la métrique. Nécessaire : `true` Type : `string` `table` Nom du tableau dans lequel stocker l'enregistrement. Spécifiez cette valeur pour remplacer le paramètre `DefaultTableName`. Nécessaire : `false` Type : `string` `value` Valeur du point de données individuel. Nécessaire : `true` Type : `float` `timestamp` Horodatage du point de données individuel. La valeur par défaut est l'heure actuelle. Nécessaire : `false` Type : `string` **Exemple d'entrée** ``` { "request": { "subject":"ef43c6d40a0a0b5700c77f9bf387afe3", "metric_name":"u_count", "table": "u_greengrass_app" "value": 1.0, "timestamp": "2018-10-14T10:30:00" } } ``` ## Données de sortie Ce connecteur publie des informations d'état sous forme de données de sortie dans une rubrique MQTT. **Filtre de rubrique dans l'abonnement** `servicenow/metricbase/metric/status` **Exemple de sortie : réussite** ``` { "response": { "metric_name": "Errors", "table_name": "GliderProd", "processed_on": "2018-10-14T10:35:00", "response_id": "khjKSkj132qwr23fcba", "status": "success", "values": [ { "timestamp": "2016-10-14T10:30:00", "value": 1.0 }, { "timestamp": "2016-10-14T10:31:00", "value": 1.1 } ] } } ``` **Exemple de sortie : échec** ``` { "response": { "error": "InvalidInputException", "error_message": "metric value is invalid", "status": "fail" } } ``` Si le connecteur détecte une erreur réessayable (par exemple, des erreurs de connexion), il réessaie de publier dans le lot suivant. ## Exemple d'utilisation Suivez les étapes de haut niveau suivantes pour configurer un exemple de fonction Lambda en Python 3.7 que vous pouvez utiliser pour tester le connecteur. **Note** Si vous utilisez d'autres environnements d'exécution Python, vous pouvez créer un lien symbolique entre Python3.x et Python 3.7. Les rubriques [Démarrer avec les connecteurs (console)](connectors-console.md) et [Démarrer avec les connecteurs (CLI)](connectors-cli.md) contiennent des étapes détaillées qui vous montrent comment configurer et déployer un exemple de connecteur Twilio Notifications. 1. Veillez à répondre aux [conditions requises](#servicenow-connector-req) pour le connecteur. 1. Créez et publiez une fonction Lambda qui envoie des données d'entrée au connecteur. Enregistrez l'[exemple de code](#servicenow-connector-usage-example) en tant que fichier PY. Téléchargez et décompressez le [SDK AWS IoT Greengrass de base pour Python](lambda-functions.md#lambda-sdks-core). Ensuite, créez un package zip contenant le fichier PY et le dossier `greengrasssdk` au niveau racine. Ce package zip est le package de déploiement vers lequel vous effectuez le téléchargement AWS Lambda. Après avoir créé la fonction Lambda de Python 3.7, publiez une version de la fonction et créez un alias. 1. Configurez votre groupe Greengrass. 1. Ajoutez la fonction Lambda par son alias (recommandé). Configurez le cycle de vie Lambda comme étant de longue durée (ou dans `"Pinned": true` la CLI). 1. Ajoutez la ressource secrète requise et accordez un accès en lecture à la fonction Lambda. 1. Ajoutez le connecteur et configurez ses [paramètres](#servicenow-connector-param). 1. Ajoutez des abonnements qui permettent au connecteur de recevoir des [données d'entrée](#servicenow-connector-data-input) et d'envoyer des [données de sortie](#servicenow-connector-data-output) sur des filtres de rubrique pris en charge. + Définissez la fonction Lambda comme source, le connecteur comme cible et utilisez un filtre de rubrique d'entrée compatible. + Définissez le connecteur en tant que source, AWS IoT Core en tant que cible et utilisez un filtre de rubrique de sortie pris en charge. Vous utilisez cet abonnement pour afficher les messages d'état dans la AWS IoT console. 1. Déployez le groupe. 1. Dans la AWS IoT console, sur la page **Test**, abonnez-vous à la rubrique des données de sortie pour consulter les messages d'état du connecteur. L'exemple de fonction Lambda a une longue durée de vie et commence à envoyer des messages immédiatement après le déploiement du groupe. Lorsque vous avez terminé les tests, vous pouvez définir le cycle de vie Lambda à la demande (ou `"Pinned": false` dans la CLI) et déployer le groupe. Cela empêche la fonction d'envoyer des messages. ### exemple L'exemple suivant de fonction Lambda envoie un message d'entrée au connecteur. ``` import greengrasssdk import json iot_client = greengrasssdk.client('iot-data') SEND_TOPIC = 'servicenow/metricbase/metric' def create_request_with_all_fields(): return { "request": { "subject": '2efdf6badbd523803acfae441b961961', "metric_name": 'u_count', "value": 1234, "timestamp": '2018-10-20T20:22:20', "table": 'u_greengrass_metricbase_test' } } def publish_basic_message(): messageToPublish = create_request_with_all_fields() print("Message To Publish: ", messageToPublish) iot_client.publish(topic=SEND_TOPIC, payload=json.dumps(messageToPublish)) publish_basic_message() def lambda_handler(event, context): return ``` ## Licences Le connecteur ServiceNow MetricBase d'intégration inclut les logiciels/licences tiers suivants : + [pysnow](https://github.com/rbw/pysnow)/MIT Ce connecteur est publié dans le cadre du contrat de [licence logicielle Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Journal des modifications Le tableau suivant décrit les modifications apportées à chaque version du connecteur. | Version | Modifications | | --- | --- | | 4 | Ajout du paramètre `IsolationMode` pour configurer le mode de conteneurisation du connecteur. | | 3 | Mise à niveau de l'environnement d'exécution Lambda vers Python 3.7, ce qui modifie les exigences d'exécution. | | 2 | Correctif pour réduire la journalisation excessive. | | 1 | Première version. | Un groupe Greengrass ne peut contenir qu'une seule version du connecteur à la fois. Pour de plus amples informations sur la mise à niveau d'une version de connecteur, veuillez consulter [Mise à niveau des versions du connecteur](connectors.md#upgrade-connector-versions). ## Consultez aussi + [Intégrer à des services et protocoles à l'aide de connecteurs Greengrass](connectors.md) + [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md) + [Démarrage avec les connecteurs Greengrass (CLI)](connectors-cli.md)