Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1 Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # ServiceNow MetricBase Connettore di integrazione **avvertimento** Questo connettore è entrato nella *fase di vita prolungata* e AWS IoT Greengrass non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti alle funzionalità esistenti, patch di sicurezza o correzioni di bug. Per ulteriori informazioni, consulta [AWS IoT Greengrass Version 1 politica di manutenzione](maintenance-policy.md). Il [connettore ServiceNow MetricBase ](connectors.md) Integration pubblica le metriche delle serie temporali dai dispositivi Greengrass su. ServiceNow MetricBase In questo modo potrai archiviare, analizzare e visualizzare i dati delle serie temporali dall'ambiente core di Greengrass e agire sugli eventi locali. Questo connettore riceve dati di serie temporali su un argomento MQTT e li pubblica nell'API a intervalli regolari. ServiceNow Puoi utilizzare questo connettore per supportare molti scenari, ad esempio: + Creazione di avvisi basati su soglie e allarmi basati sui dati delle serie temporali raccolti dai dispositivi Greengrass. + Usa i dati dei servizi temporali dei dispositivi Greengrass con applicazioni personalizzate basate sulla ServiceNow piattaforma. Questo connettore ha le seguenti versioni. | Versione | 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` | Per informazioni sulle modifiche di ogni versione, consulta [Changelog](#servicenow-connector-changelog). ## Requisiti Questo connettore presenta i seguenti requisiti: ------ #### [ Version 3 - 4 ] + AWS IoT Greengrass Software principale v1.9.3 o successivo. AWS IoT Greengrass [deve essere configurato per supportare i segreti locali, come descritto in Secrets Requirements.](secrets.md#secrets-reqs) **Nota** Questo requisito include l'autorizzazione all'accesso ai segreti di Secrets Manager. *Se utilizzi il ruolo di servizio Greengrass predefinito, Greengrass è autorizzato a ottenere i valori dei segreti con nomi che iniziano con greengrass-.* + [Python](https://www.python.org/) versione 3.7 o 3.8 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH. **Nota** Per usare Python 3.8, esegui il seguente comando per creare un collegamento simbolico dalla cartella di installazione predefinita di Python 3.7 ai binari Python 3.8 installati. ``` sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7 ``` Questo configura il dispositivo in modo che soddisfi il requisito Python per AWS IoT Greengrass. + Un account con un abbonamento attivato a. ServiceNow MetricBase Inoltre, nell'account è necessario creare un parametro e una tabella dei parametri. Per ulteriori informazioni, [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)consulta la ServiceNow documentazione. + Un tipo di testo segreto Gestione dei segreti AWS che memorizza il nome utente e la password per accedere all' ServiceNow istanza con l'autenticazione di base. Il segreto deve includere le chiavi "utente" e "password" con i valori corrispondenti. Per ulteriori informazioni, consulta [Creazione di un segreto di base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) nella *Guida Gestione dei segreti AWS per l'utente*. + Una risorsa segreta del gruppo Greengrass che fa riferimento al segreto di Secrets Manager. Per ulteriori informazioni, consulta [Distribuisci segreti a AWS IoT Greengrass core](secrets.md). ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Software principale v1.7 o successivo. AWS IoT Greengrass deve essere configurato per supportare i segreti locali, come descritto in [Secrets Requirements](secrets.md#secrets-reqs). **Nota** Questo requisito include l'autorizzazione all'accesso ai segreti di Secrets Manager. *Se utilizzi il ruolo di servizio Greengrass predefinito, Greengrass è autorizzato a ottenere i valori dei segreti con nomi che iniziano con greengrass-.* + [Python](https://www.python.org/) versione 2.7 installato sul dispositivo principale e aggiunto alla variabile di ambiente PATH. + Un ServiceNow account con un abbonamento attivato a. MetricBase Inoltre, nell'account è necessario creare un parametro e una tabella dei parametri. Per ulteriori informazioni, [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)consulta la ServiceNow documentazione. + Un tipo di testo segreto Gestione dei segreti AWS che memorizza il nome utente e la password per accedere all' ServiceNow istanza con l'autenticazione di base. Il segreto deve includere le chiavi "utente" e "password" con i valori corrispondenti. Per ulteriori informazioni, consulta [Creazione di un segreto di base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) nella *Guida Gestione dei segreti AWS per l'utente*. + Una risorsa segreta del gruppo Greengrass che fa riferimento al segreto di Secrets Manager. Per ulteriori informazioni, consulta [Distribuisci segreti a AWS IoT Greengrass core](secrets.md). ------ ## Parametri del connettore Questo connettore fornisce i seguenti parametri: ------ #### [ Version 4 ] `PublishInterval` Il numero massimo di secondi di attesa tra gli eventi di pubblicazione ServiceNow. Il valore massimo è 900. Il connettore pubblica ServiceNow quando `PublishBatchSize` viene raggiunto o `PublishInterval` scade. Nome visualizzato nella AWS IoT console: **intervallo di pubblicazione** in secondi Obbligatorio: `true` Tipo: `string` Valori validi: `1 - 900` Schema valido: `[1-9]|[1-9]\d|[1-9]\d\d|900` `PublishBatchSize` Il numero massimo di valori delle metriche che possono essere raggruppati in batch prima della loro pubblicazione. ServiceNow Il connettore pubblica ServiceNow quando `PublishBatchSize` viene raggiunto o scade. `PublishInterval` Nome visualizzato nella AWS IoT console: dimensione del batch di **pubblicazione** Obbligatorio: `true` Tipo: `string` Modello valido: `^[0-9]+$` `InstanceName` Il nome dell'istanza utilizzata per la connessione ServiceNow. Nome visualizzato nella AWS IoT console: **nome dell' ServiceNow istanza** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `DefaultTableName` Il nome della tabella che contiene le informazioni `GlideRecord` associate al MetricBase database delle serie temporali. La proprietà `table` nel payload del messaggio di input può essere utilizzata per sostituire questo valore. Nome visualizzato nella AWS IoT console: **nome della tabella che contiene la metrica** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `MaxMetricsToRetain` Il numero massimo di parametri da salvare in memoria prima che vengano sostituiti con nuovi parametri. Questo limite è valido quando non è presente una connessione a Internet e il connettore inizia il buffering dei parametri da pubblicare successivamente. Quando il buffer è pieno, i parametri meno recenti vengono sostituiti da quelli nuovi. I parametri non vengono salvati se si interrompe il processo host del connettore. Ad esempio, ciò potrebbe verificarsi durante la distribuzione dei gruppi o al riavvio del dispositivo. Il valore deve essere superiore alle dimensioni del batch e abbastanza grande da contenere messaggi in base alla velocità in entrata dei messaggi MQTT. Nome visualizzato nella AWS IoT console: **numero massimo di metriche da conservare in memoria** Obbligatorio: `true` Tipo: `string` Modello valido: `^[0-9]+$` `AuthSecretArn` Il segreto Gestione dei segreti AWS che memorizza il nome ServiceNow utente e la password. Deve essere un segreto in formato testo. Il segreto deve includere le chiavi "utente" e "password" con i valori corrispondenti. Nome visualizzato nella AWS IoT console: **ARN del segreto di autenticazione** Obbligatorio: `true` Tipo: `string` Modello valido: `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 risorsa segreta del gruppo che fa riferimento al segreto di Secrets Manager per le ServiceNow credenziali. Nome visualizzato nella AWS IoT console: risorsa token di **autenticazione** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `IsolationMode` Modalità di [containerizzazione](connectors.md#connector-containerization) per questo connettore. L'impostazione predefinita è`GreengrassContainer`, il che significa che il connettore viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore. L'impostazione predefinita della containerizzazione per il gruppo non si applica ai connettori. Nome visualizzato nella AWS IoT console: **modalità di isolamento del contenitore** Obbligatorio: `false` Tipo: `string` Valori validi: `GreengrassContainer` o `NoContainer` Modello valido: `^NoContainer$|^GreengrassContainer$` ------ #### [ Version 1 - 3 ] `PublishInterval` Il numero massimo di secondi di attesa tra gli eventi di pubblicazione ServiceNow. Il valore massimo è 900. Il connettore pubblica ServiceNow quando `PublishBatchSize` viene raggiunto o `PublishInterval` scade. Nome visualizzato nella AWS IoT console: **intervallo di pubblicazione** in secondi Obbligatorio: `true` Tipo: `string` Valori validi: `1 - 900` Schema valido: `[1-9]|[1-9]\d|[1-9]\d\d|900` `PublishBatchSize` Il numero massimo di valori delle metriche che possono essere raggruppati in batch prima della loro pubblicazione. ServiceNow Il connettore pubblica ServiceNow quando `PublishBatchSize` viene raggiunto o scade. `PublishInterval` Nome visualizzato nella AWS IoT console: dimensione del batch di **pubblicazione** Obbligatorio: `true` Tipo: `string` Modello valido: `^[0-9]+$` `InstanceName` Il nome dell'istanza utilizzata per la connessione ServiceNow. Nome visualizzato nella AWS IoT console: **nome dell' ServiceNow istanza** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `DefaultTableName` Il nome della tabella che contiene le informazioni `GlideRecord` associate al MetricBase database delle serie temporali. La proprietà `table` nel payload del messaggio di input può essere utilizzata per sostituire questo valore. Nome visualizzato nella AWS IoT console: **nome della tabella che contiene la metrica** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` `MaxMetricsToRetain` Il numero massimo di parametri da salvare in memoria prima che vengano sostituiti con nuovi parametri. Questo limite è valido quando non è presente una connessione a Internet e il connettore inizia il buffering dei parametri da pubblicare successivamente. Quando il buffer è pieno, i parametri meno recenti vengono sostituiti da quelli nuovi. I parametri non vengono salvati se si interrompe il processo host del connettore. Ad esempio, ciò potrebbe verificarsi durante la distribuzione dei gruppi o al riavvio del dispositivo. Il valore deve essere superiore alle dimensioni del batch e abbastanza grande da contenere messaggi in base alla velocità in entrata dei messaggi MQTT. Nome visualizzato nella AWS IoT console: **numero massimo di metriche da conservare in memoria** Obbligatorio: `true` Tipo: `string` Modello valido: `^[0-9]+$` `AuthSecretArn` Il segreto Gestione dei segreti AWS che memorizza il nome ServiceNow utente e la password. Deve essere un segreto in formato testo. Il segreto deve includere le chiavi "utente" e "password" con i valori corrispondenti. Nome visualizzato nella AWS IoT console: **ARN del segreto di autenticazione** Obbligatorio: `true` Tipo: `string` Modello valido: `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 risorsa segreta del gruppo che fa riferimento al segreto di Secrets Manager per le ServiceNow credenziali. Nome visualizzato nella AWS IoT console: risorsa token di **autenticazione** Obbligatorio: `true` Tipo: `string` Modello valido: `.+` ------ ### Esempio di creazione di connettore (AWS CLI) Il seguente comando CLI crea un `ConnectorDefinition` con una versione iniziale che contiene il connettore di ServiceNow MetricBase integrazione. ``` 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" } } ] }' ``` **Nota** La funzione Lambda in questo connettore ha un ciclo di vita di [lunga durata](lambda-functions.md#lambda-lifecycle). **Nella AWS IoT Greengrass console, puoi aggiungere un connettore dalla pagina Connettori del gruppo.** Per ulteriori informazioni, consulta [Nozioni di base sui connettori Greengrass (console)](connectors-console.md). ## Dati di input Questo connettore accetta le metriche delle serie temporali su un argomento MQTT e le pubblica su. ServiceNow I messaggi di input devono essere in formato JSON. **Filtro argomento in sottoscrizione** `servicenow/metricbase/metric` **Proprietà dei messaggi** `request` Informazioni sulla tabella, sul record e sul parametro. Questa richiesta rappresenta l'oggetto `seriesRef` in una richiesta POST delle serie temporali. Per ulteriori informazioni, consulta [API delle serie temporali Clotho - POST](https://docs.servicenow.com/bundle/london-application-development/page/integrate/inbound-rest/concept/Clotho-Time-Series-API.html#clotho-POST-put). Obbligatorio: `true` Tipo: `object` che include le seguenti proprietà: `subject` Il valore `sys_id` del record specifico della tabella. Obbligatorio: `true` Tipo: `string` `metric_name` Il nome del campo del parametro. Obbligatorio: `true` Tipo: `string` `table` Il nome della tabella in cui memorizzare il record. Specifica questo valore per sostituire il parametro `DefaultTableName`. Obbligatorio: `false` Tipo: `string` `value` Il valore del punto dati individuale. Obbligatorio: `true` Tipo: `float` `timestamp` Il timestamp del punto dati individuale. Il valore predefinito è l'ora corrente. Obbligatorio: `false` Tipo: `string` **Input di esempio** ``` { "request": { "subject":"ef43c6d40a0a0b5700c77f9bf387afe3", "metric_name":"u_count", "table": "u_greengrass_app" "value": 1.0, "timestamp": "2018-10-14T10:30:00" } } ``` ## Dati di output Questo connettore pubblica le informazioni di stato come dati di output su un argomento MQTT. **Filtro argomento in sottoscrizione** `servicenow/metricbase/metric/status` **Output di esempio: Operazione riuscita** ``` { "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 } ] } } ``` **Esempio di output: Errore** ``` { "response": { "error": "InvalidInputException", "error_message": "metric value is invalid", "status": "fail" } } ``` Se il connettore rileva un errore riutilizzabile (ad esempio errori di connessione), riprova la pubblicazione nel batch successivo. ## Esempio di utilizzo Usa i seguenti passaggi di alto livello per configurare una funzione Lambda di esempio di Python 3.7 che puoi usare per provare il connettore. **Nota** Se usi altri runtime Python, puoi creare un collegamento simbolico da Python 3.7. Python3.x Gli argomenti [Nozioni di base sui connettori (console)](connectors-console.md) e [Nozioni di base sui connettori (CLI)](connectors-cli.md) contengono passaggi dettagliati che illustrano come configurare e distribuire un connettore Twilio Notifications di esempio. 1. Assicurarsi di soddisfare i [requisiti](#servicenow-connector-req) per il connettore. 1. Crea e pubblica una funzione Lambda che invia dati di input al connettore. Salvare il [codice di esempio](#servicenow-connector-usage-example) come file PY. Scarica e decomprimi il [AWS IoT Greengrass Core SDK per Python](lambda-functions.md#lambda-sdks-core). Quindi, crea un pacchetto zip che contiene il file PY e la cartella `greengrasssdk` a livello root. Questo pacchetto zip è il pacchetto di distribuzione in cui carichi. AWS Lambda Dopo aver creato la funzione Python 3.7 Lambda, pubblica una versione della funzione e crea un alias. 1. Configurare il gruppo Greengrass. 1. Aggiungi la funzione Lambda tramite il relativo alias (consigliato). Configura il ciclo di vita Lambda come longevo (o nella `"Pinned": true` CLI). 1. Aggiungi la risorsa segreta richiesta e concedi l'accesso in lettura alla funzione Lambda. 1. Aggiungere il connettore e configurarne i relativi [parametri](#servicenow-connector-param). 1. Aggiungere sottoscrizioni che consentono al connettore di ricevere [i dati di input](#servicenow-connector-data-input) e inviare [i dati di output](#servicenow-connector-data-output) nei filtri degli argomenti supportati. + Imposta la funzione Lambda come origine, il connettore come destinazione e utilizza un filtro per argomenti di input supportato. + Imposta il connettore come origine, AWS IoT Core come destinazione e utilizza un filtro per l’argomento di output supportato. Utilizzi questo abbonamento per visualizzare i messaggi di stato nella AWS IoT console. 1. Distribuisci il gruppo. 1. Nella AWS IoT console, nella pagina **Test**, sottoscrivi l'argomento relativo ai dati di output per visualizzare i messaggi di stato dal connettore. La funzione Lambda di esempio è di lunga durata e inizia a inviare messaggi subito dopo l'implementazione del gruppo. Al termine del test, puoi impostare il ciclo di vita Lambda su richiesta (o nella CLI) e `"Pinned": false` distribuire il gruppo. Ciò impedisce alla funzione di inviare messaggi. ### Esempio L'esempio seguente della funzione Lambda invia un messaggio di input al connettore. ``` 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 ``` ## Licenze Il connettore di ServiceNow MetricBase integrazione include le seguenti terze parti software/licensing: + [pysnow](https://github.com/rbw/pysnow)/MIT Questo connettore è rilasciato ai sensi del contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog La tabella seguente descrive le modifiche apportate a ciascuna versione del connettore. | Versione | Modifiche | | --- | --- | | 4 | Aggiunto il parametro `IsolationMode` per configurare la modalità di containerizzazione per il connettore. | | 3 | È stato aggiornato il runtime Lambda a Python 3.7, che modifica i requisiti di runtime. | | 2 | Correggere per ridurre l'eccessiva registrazione di log. | | 1 | Versione iniziale. | Un gruppo Greengrass può contenere una sola versione del connettore alla volta. Per informazioni sull'aggiornamento di una versione del connettore, consulta [Aggiornamento delle versioni dei connettori](connectors.md#upgrade-connector-versions). ## Consulta anche + [Integrazione con servizi e protocolli tramite i connettori Greengrass](connectors.md) + [Nozioni di base sui connettori Greengrass (console)](connectors-console.md) + [Nozioni di base sui connettori Greengrass (CLI)](connectors-cli.md)