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à. # Connettore di integrazione Splunk **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](connectors.md) Splunk Integration pubblica i dati dai dispositivi Greengrass su Splunk. In questo modo potrai utilizzare Splunk per monitorare e analizzare l'ambiente core di Greengrass e agire sugli eventi locali. Il connettore si integra con HTTP Event Collector (HEC). Per ulteriori informazioni, consulta [Introduzione a Splunk HTTP Event Collector](https://dev.splunk.com/view/event-collector/SP-CAAAE6M) nella documentazione di Splunk. Questo connettore riceve dati di eventi e di logging in un argomento MQTT e pubblica i dati così come sono nell'API Splunk. Puoi utilizzare questo connettore per supportare scenari industriali, ad esempio: + Gli operatori possono utilizzare i dati periodici di attuatori e sensori (ad esempio, letture di temperatura, pressione e acqua) per avviare allarmi quando i valori superano determinate soglie. + Gli sviluppatori utilizzano i dati raccolti dai macchinari industriali per creare modelli ML in grado di monitorare le apparecchiature in vista di potenziali problemi. Questo connettore ha le seguenti versioni. | Versione | ARN | | --- | --- | | 4 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/4` | | 3 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/3` | | 2 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/2` | | 1 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/1` | Per informazioni sulle modifiche di ogni versione, consulta [Changelog](#splunk-connector-changelog). ## Requisiti Questo connettore presenta i seguenti requisiti: ------ #### [ Version 3 - 4 ] + AWS IoT Greengrass Software principale v1.9.3 o versione successiva. 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. + La funzionalità HTTP Event Collector deve essere abilitata in Splunk. Per ulteriori informazioni, consulta [Configurazione e utilizzo di HTTP Event Collector in Splunk Web](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector) nella documentazione di Splunk. + Un tipo di testo segreto Gestione dei segreti AWS che memorizza il token Splunk HTTP Event Collector. *Per maggiori informazioni, consulta [About event collector tokens](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector#About_Event_Collector_tokens) nella documentazione di Splunk e [Creazione di un segreto di base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) nella Guida per l'utente.Gestione dei segreti AWS * **Nota** Per creare il segreto nella console Secrets Manager, inserisci il tuo token nella scheda **Plaintext**. Non includere virgolette o altri tipi di formattazione. Nell'API, specifica il token come valore per la `SecretString` proprietà. + Una risorsa segreta del gruppo Greengrass che fa riferimento al segreto di Secrets Manager. Per ulteriori informazioni, consulta [Implementa i segreti fino al nucleo AWS IoT Greengrass](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. + La funzionalità HTTP Event Collector deve essere abilitata in Splunk. Per ulteriori informazioni, consulta [Configurazione e utilizzo di HTTP Event Collector in Splunk Web](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector) nella documentazione di Splunk. + Un tipo di testo segreto Gestione dei segreti AWS che memorizza il token Splunk HTTP Event Collector. *Per maggiori informazioni, consulta [About event collector tokens](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector#About_Event_Collector_tokens) nella documentazione di Splunk e [Creazione di un segreto di base](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) nella Guida per l'utente.Gestione dei segreti AWS * **Nota** Per creare il segreto nella console Secrets Manager, inserisci il tuo token nella scheda **Plaintext**. Non includere virgolette o altri tipi di formattazione. Nell'API, specifica il token come valore per la `SecretString` proprietà. + Una risorsa segreta del gruppo Greengrass che fa riferimento al segreto di Secrets Manager. Per ulteriori informazioni, consulta [Implementa i segreti fino al nucleo AWS IoT Greengrass](secrets.md). ------ ## Parametri del connettore Questo connettore fornisce i seguenti parametri: ------ #### [ Version 4 ] `SplunkEndpoint` L'endpoint dell'istanza database Splunk. Questo valore deve contenere il protocollo, il nome host e la porta. Nome visualizzato nella AWS IoT console: **Splunk endpoint** Obbligatorio: `true` Tipo: `string` Schema valido: `^(http:\/\/|https:\/\/)?[a-z0-9]+([-.]{1}[a-z0-9]+)*.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$` `MemorySize` La quantità di memoria (in KB) da allocare al connettore. Nome visualizzato nella AWS IoT console: **dimensione della memoria** Obbligatorio: `true` Tipo: `string` Schema valido: `^[0-9]+$` `SplunkQueueSize` Il numero massimo di voci da salvare in memoria prima che vengono inviate o eliminate. Quando si raggiunge questo limite, le voci meno recenti in coda vengono sostituite da quelle più recenti. Questo limite si applica in genere in assenza di una connessione a Internet. Nome visualizzato nella AWS IoT console: **numero massimo di elementi da conservare** Obbligatorio: `true` Tipo: `string` Schema valido: `^[0-9]+$` `SplunkFlushIntervalSeconds` L'intervallo di tempo (in secondi) per la pubblicazione dei dati ricevuti in Splunk HEC. Il valore massimo è 900. Per configurare il connettore in modo da pubblicare gli elementi man mano che vengono ricevuti (senza raggruppamento), specificare 0. Nome visualizzato nella AWS IoT console: intervallo di **pubblicazione Splunk** Obbligatorio: `true` Tipo: `string` Schema valido: `[0-9]|[1-9]\d|[1-9]\d\d|900` `SplunkTokenSecretArn` Il segreto Gestione dei segreti AWS che contiene il token Splunk. Deve essere un segreto in formato testo. Nome visualizzato nella AWS IoT console: **ARN del token di autenticazione Splunk secret** Obbligatorio: `true` Tipo: `string` Schema valido: `arn:aws:secretsmanager:[a-z]{2}-[a-z]+-\d{1}:\d{12}?:secret:[a-zA-Z0-9-_]+-[a-zA-Z0-9-_]+` `SplunkTokenSecretArn-ResourceId` La risorsa segreta nel gruppo Greengrass che fa riferimento al segreto Splunk. Nome visualizzato nella AWS IoT console: risorsa del token di **autenticazione Splunk** Obbligatorio: `true` Tipo: `string` Schema valido: `.+` `SplunkCustomCALocation` Il percorso del file dell'autorità di certificazione (CA) personalizzata per Splunk (ad esempio `/etc/ssl/certs/splunk.crt`). Nome visualizzato nella AWS IoT console: posizione **personalizzata dell'autorità di certificazione Splunk** Obbligatorio: `false` Tipo: `string` Schema 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` Schema valido: `^NoContainer$|^GreengrassContainer$` ------ #### [ Version 1 - 3 ] `SplunkEndpoint` L'endpoint dell'istanza database Splunk. Questo valore deve contenere il protocollo, il nome host e la porta. Nome visualizzato nella AWS IoT console: **Splunk endpoint** Obbligatorio: `true` Tipo: `string` Schema valido: `^(http:\/\/|https:\/\/)?[a-z0-9]+([-.]{1}[a-z0-9]+)*.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$` `MemorySize` La quantità di memoria (in KB) da allocare al connettore. Nome visualizzato nella AWS IoT console: **dimensione della memoria** Obbligatorio: `true` Tipo: `string` Schema valido: `^[0-9]+$` `SplunkQueueSize` Il numero massimo di voci da salvare in memoria prima che vengono inviate o eliminate. Quando si raggiunge questo limite, le voci meno recenti in coda vengono sostituite da quelle più recenti. Questo limite si applica in genere in assenza di una connessione a Internet. Nome visualizzato nella AWS IoT console: **numero massimo di elementi da conservare** Obbligatorio: `true` Tipo: `string` Schema valido: `^[0-9]+$` `SplunkFlushIntervalSeconds` L'intervallo di tempo (in secondi) per la pubblicazione dei dati ricevuti in Splunk HEC. Il valore massimo è 900. Per configurare il connettore in modo da pubblicare gli elementi man mano che vengono ricevuti (senza raggruppamento), specificare 0. Nome visualizzato nella AWS IoT console: Intervallo di **pubblicazione di Splunk** Obbligatorio: `true` Tipo: `string` Schema valido: `[0-9]|[1-9]\d|[1-9]\d\d|900` `SplunkTokenSecretArn` Il segreto Gestione dei segreti AWS che contiene il token Splunk. Deve essere un segreto in formato testo. Nome visualizzato nella AWS IoT console: **ARN del token di autenticazione Splunk secret** Obbligatorio: `true` Tipo: `string` Schema valido: `arn:aws:secretsmanager:[a-z]{2}-[a-z]+-\d{1}:\d{12}?:secret:[a-zA-Z0-9-_]+-[a-zA-Z0-9-_]+` `SplunkTokenSecretArn-ResourceId` La risorsa segreta nel gruppo Greengrass che fa riferimento al segreto Splunk. Nome visualizzato nella AWS IoT console: risorsa del token di **autenticazione Splunk** Obbligatorio: `true` Tipo: `string` Schema valido: `.+` `SplunkCustomCALocation` Il percorso del file dell'autorità di certificazione (CA) personalizzata per Splunk (ad esempio `/etc/ssl/certs/splunk.crt`). Nome visualizzato nella AWS IoT console: posizione **personalizzata dell'autorità di certificazione Splunk** Obbligatorio: `false` Tipo: `string` Schema valido: `^$|/.*` ------ ### Esempio di creazione di un connettore (AWS CLI) Il seguente comando CLI crea una `ConnectorDefinition` versione iniziale che contiene il connettore Splunk Integration. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MySplunkIntegrationConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/4", "Parameters": { "SplunkEndpoint": "https://myinstance.cloud.splunk.com:8088", "MemorySize": 200000, "SplunkQueueSize": 10000, "SplunkFlushIntervalSeconds": 5, "SplunkTokenSecretArn":"arn:aws:secretsmanager:region:account-id:secret:greengrass-secret-hash", "SplunkTokenSecretArn-ResourceId": "MySplunkResource", "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 dati di registrazione ed eventi su un argomento MQTT e pubblica i dati ricevuti così come sono nell'API Splunk. I messaggi di input devono essere in formato JSON. **Filtro argomento in sottoscrizione** `splunk/logs/put` **Proprietà dei messaggi** `request` I dati dell'evento da inviare all'API Splunk. Gli eventi devono soddisfare le specifiche dell'API [services/collector](https://docs.splunk.com/Documentation/Splunk/latest/RESTREF/RESTinput#services.2Fcollector). Obbligatorio: `true` Tipo:`object`. È obbligatoria solo la proprietà `event`. `id` Un ID arbitrario della richiesta. Questa proprietà viene utilizzata per associare una richiesta di input a uno stato di output. Richiesto: `false` Tipo: `string` **Limiti** Tutti i limiti imposti dall'API Splunk vengono applicati quando si utilizza questo connettore. Per ulteriori informazioni, consulta [services/collector](https://docs.splunk.com/Documentation/Splunk/latest/RESTREF/RESTinput#services.2Fcollector). **Input di esempio** ``` { "request": { "event": "some event", "fields": { "severity": "INFO", "category": [ "value1", "value2" ] } }, "id": "request123" } ``` ## Dati di output Questo connettore pubblica i dati di output in due argomenti: + Informazioni di stato nell'argomento `splunk/logs/put/status`. + Gli errori nell'argomento `splunk/logs/put/error`. **Filtro di argomenti:** `splunk/logs/put/status` Utilizza questo argomento per ascoltare lo stato delle richieste. Ogni volta che il connettore invia un batch di dati ricevuti all'API Splunk, pubblica un elenco IDs delle richieste riuscite e non riuscite. **Output di esempio** ``` { "response": { "succeeded": [ "request123", ... ], "failed": [ "request789", ... ] } } ``` **Filtro di argomenti:** `splunk/logs/put/error` Utilizza questo argomento per ascoltare gli errori del connettore. La proprietà `error_message` che descrive l'errore o il timeout rilevato durante l'elaborazione della richiesta. **Output di esempio** ``` { "response": { "error": "UnauthorizedException", "error_message": "invalid splunk token", "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 Python3.x a Python 3.7. 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](#splunk-connector-req) per il connettore. 1. Crea e pubblica una funzione Lambda che invia dati di input al connettore. Salvare il [codice di esempio](#splunk-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](#splunk-connector-param). 1. Aggiungere sottoscrizioni che consentono al connettore di ricevere [i dati di input](#splunk-connector-data-input) e inviare [i dati di output](#splunk-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 time import json iot_client = greengrasssdk.client('iot-data') send_topic = 'splunk/logs/put' def create_request_with_all_fields(): return { "request": { "event": "Access log test message." }, "id" : "req_123" } 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 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)