Splunk

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione CreateHTTPEvent

Questa azione ti consente di inviare dati ed eventi dell'applicazione a un deployment Splunk tramite i protocolli HTTP e HTTPS.

Parametri di input dell'azione CreateHTTPEvent

Parametri di output dell'azione CreateHTTPEvent

Questa azione restituisce lo stato di riuscita dell'evento creato.

Azione CreateIndex

Questa azione ti consente di creare indici.

Parametri di input dell'azione CreateIndex

Parametri di output dell'azione CreateIndex

Questa azione restituisce il messaggio di conferma dell'azione CreateIndex.

Per un esempio di come configurare l'azione CreateIndex, consulta Esempi di azioni.

Azione CreateSavedSearch

Questa azione ti consente di salvare le ricerche

Parametri di input dell'azione CreateSavedSearch

Parametri di output dell'azione CreateSavedSearch

Questa azione restituisce il messaggio di conferma dell'azione CreateSavedSearch.

Per un esempio di come configurare l'azione CreateSavedSearch, consulta Esempi di azioni.

Azione UpdateSavedSearch

Questa azione ti consente di aggiornare una ricerca salvata.

Parametri di input dell'azione UpdateSavedSearch

Parametri di output dell'azione UpdateSavedSearch

Questa azione restituisce il messaggio di conferma dell'azione UpdateSavedSearch.

Per un esempio di come configurare l'azione UpdateSavedSearch, consulta Esempi di azioni.

Azione DeleteIndex

Questa azione ti consente di eliminare un indice.

Parametri di input dell'azione DeleteIndex

Parametri di output dell'azione DeleteIndex

Questa azione restituisce il messaggio di conferma dell'azione DeleteIndex

Per un esempio di come configurare l'azione DeleteIndex, consulta Esempi di azioni.

Azione UpdateIndex

Questa azione ti consente di aggiornare un indice.

Parametri di input dell'azione UpdateIndex

Parametri di output dell'azione UpdateIndex

Questa azione restituisce il messaggio di conferma dell'azione UpdateIndex.

Per un esempio di come configurare l'azione UpdateIndex, consulta Esempi di azioni.

Esempi di azioni

Esempio: crea un evento HTTP

Questo esempio crea un evento HTTP.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateHTTPEvent, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "EventContent": "Testing Task",
   "ContentType": "RAWTEXT",
   "ChannelGUID": "ContentType=RAWTEXT"
   }

Se l'azione ha esito positivo, il parametro CreateHTTPEvent della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": "Success"
}] 

Esempio: creare un indice

Questo esempio crea un indice.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateIndex, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Name": "http_testing"
   }

Se l'azione ha esito positivo, il parametro CreateIndex della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"AssureUTF8": null,
"BlockSignSize": null,
"BlockSignatureDatabase": null,
"BucketRebuildMemoryHint": null,
"ColdPath": null,
"FrozenTimePeriodInSecs": null,
"HomePath": null,
"HomePathExpanded": null,
"IndexThreads": null,
"IsInternal": null,
"MaxConcurrentOptimizes": null,
"MaxDataSize": null,
"MaxHotBuckets": null,
"SuppressBannerList": null,
"Sync": null,
"SyncMeta": null,
"ThawedPath": null,
"ThawedPathExpanded": null,
"TstatsHomePath": null,
"WarmToColdScript": null,
}]

Esempio: creare una ricerca salvata

Questo esempio crea una ricerca salvata.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateSavedSearch, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Name": "test_created_g",
   "Search": "index=\"http_testing\"",
   "CronSchedule": "*/1 * * * *",
   "IsVisible": true,
   "RealTimeSchedule": true,
   "RunOnStartup": true,
   "IsScheduled": true,
   "SchedulePriority": "highest",
   "UserContext": "nobody"
   }

Se l'azione ha esito positivo, il parametro CreateSavedSearch della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": true,
"Message": null
}]

Esempio: aggiornare una ricerca salvata

Questo esempio aggiorna una ricerca salvata.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UpdateSavedSearch, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Name": "test_created_g",
   "Search": "index=\"december_test_data\"",
   "CronSchedule": "*/1 * * * *",
   "IsVisible": true,
   "RealTimeSchedule": true,
   "RunOnStartup": true,
   "IsScheduled": true,
   "SchedulePriority": "highest"
   }

Se l'azione ha esito positivo, il parametro UpdateSavedSearch della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": true,
"Message": null
}]

Esempio: elimina un indice

Questo esempio elimina un indice.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DeleteIndex, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Name": "g_http_testing"
   }

Se l'azione ha esito positivo, il parametro DeleteIndex della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Success": true,
"ErrorCode": null,
"ErrorMessage": null
}]

Esempio: aggiorna un indice

Questo esempio aggiorna un indice.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UpdateIndex, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "MaxTotalDataSizeMB": "400000",
   "Name": "g_http_testing"
   }

Se l'azione ha esito positivo, il parametro UpdateIndex della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"AssureUTF8": false,
"BlockSignSize": null,
"BlockSignatureDatabase": null,
"BucketRebuildMemoryHint": "auto",
"ColdPath": "$SPLUNK_DB\\g_http_testing\\colddb",
"ColdPathExpanded": "C:\\Program Files\\Splunk\\var\\lib\\splunk\\g_http_testing\\colddb",
"ColdToFrozenDir": "",
"ColdToFrozenScript": "",
"CurrentDBSizeMB": 1.0,
"DefaultDatabase": "main",
"EnableOnlineBucketRepair": true,
"EnableRealtimeSearch": true,
"FrozenTimePeriodInSecs": 1.886976E8,
"HomePath": "$SPLUNK_DB\\g_http_testing\\db",
"HomePathExpanded": "C:\\Program Files\\Splunk\\var\\lib\\splunk\\g_http_testing\\db",
"IndexThreads": "auto",
"IsInternal": false,
"LastInitTime": "2024-01-08 05:15:28.0",
"MaxBloomBackfillBucketAge": "30d",
"ThawedPath": "$SPLUNK_DB\\g_http_testing\\thaweddb",
"ThawedPathExpanded": "C:\\Program Files\\Splunk\\var\\lib\\splunk\\g_http_testing\\thaweddb",
"ThrottleCheckPeriod": 15.0,
"TotalEventCount": 0.0,
"TsidxDedupPostingsListMaxTermsLimit": 8388608.0,
"TstatsHomePath": "volume:_splunk_summaries\\$_index_name\\datamodel_summary",
"WarmToColdScript": "",
"Success": true,
"ErrorCode": null,
"ErrorMessage": null
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elencare tutti i record

Questo esempio elenca tutti i record nell'entità SearchJobs.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SearchJobs dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. (Facoltativo) Nella sezione Input attività dell'attività Connettori, puoi filtrare il set di risultati specificando una clausola di filtro. Specifica il valore della clausola di filtro sempre tra virgolette singole (').

Esempio: recuperare un record da un'entità

Questo esempio recupera un record con l'ID specificato dall'entità SearchJobs.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SearchJobs dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci 1698309163.1300 nel campo Valore predefinito.

   In questo caso, 1698309163.1300 è un ID record univoco nell'entità SearchJobs.

Esempio: creare un record in un'entità

Questo esempio crea un record nell'entità SearchJobs.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SearchJobs dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   { 
   "EventSearch": "search (index=\"antivirus_logs\") sourcetype=access_combined | rex  \"(?\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})\" | iplocation IP_address| table IP_address, City, Country" 
   } 
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività SearchJobs avrà un valore simile al seguente:

   {
   "Sid": "1699336785.1919"
   } 
   

Esempio: creare un record in un'entità

Questo esempio crea un record nell'entità DataModels.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DataModels dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Id": "Test1",
   "Acceleration": "{\"enabled\":false,\"earliest_time\":\"\",
   \"max_time\":3600,\"backfill_time\":\"\",\"source_guid\":\"\",
   \"manual_rebuilds\":false,\"poll_buckets_until_maxtime\":false,
   \"max_concurrent\":3,\"allow_skew\":\"0\",\"schedule_priority\":\"default\"
   ,\"allow_old_summaries\":false,\"hunk.file_format\":\"\",\"hunk.dfs_block_size\":0,
   \"hunk.compression_codec\":\"\",\"workload_pool\":\"\"}"
   }

   Se l'integrazione ha esito positivo, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   [{
   "Id": "Test1"
   }]

Esempio: elimina un record da un'entità

Questo esempio elimina il record con l'ID specificato nell'entità DataModels.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DataModels dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci Test1 nel campo Valore predefinito.

Esempio: aggiorna un record in un'entità

Questo esempio aggiorna un record nell'entità DataModels.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DataModels dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Acceleration": "{\"enabled\":true,\"earliest_time\":\"-3mon\",
   \"cron_schedule\":\"*/5 * * * *\",\"max_time\":60,
   \"backfill_time\":\"\",\"source_guid\":\"\",\"manual_rebuilds\":false,
   \"poll_buckets_until_maxtime\":false,\"max_concurrent\":3,
   \"allow_skew\":\"0\",\"schedule_priority\":\"default\",
   \"allow_old_summaries\":false,\"hunk.file_format\":\"\",\"hunk.dfs_block_size\":0,
   \"hunk.compression_codec\":\"\",\"workload_pool\":\"\"}"
   }

5. Fai clic su entityId, quindi inserisci /servicesNS/nobody/search/datamodel/model/Testing nel campo Valore predefinito.

   Se l'integrazione ha esito positivo, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   [{
   "Id": "/servicesNS/nobody/search/datamodel/model/Testing"
   }]

Esempio: flusso di ricerca che utilizza l'indice

Questa sezione elenca tutto il flusso di ricerca utilizzando un singolo indice e più indici.

Crea una ricerca utilizzando un singolo indice

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SearchJobs dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "EventSearch": "search (index=\"http_testing\" sourcetype=\"googlecloud-testing\") "
   }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività SearchJobs avrà un valore simile al seguente:

   {
   "Sid": "1726051471.76"
   } 
   

Operazione di elenco che utilizza il nome dell'indice utilizzato nella query di ricerca

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Index Name dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause, ad esempio Sid= '1726051471.76'.

Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Index Name avrà un valore simile al seguente:

[{
  "_bkt": "http_testing~0~D043151E-5A2D-4FAB-8647-4D5DA2F288AF",
  "_cd": "00:04:00",
  "_eventtype_color": null,
  "_indextime": 1.720702012E9,
  "_kv": null,
  "_raw": "hi How r yo\nplease\nfind \nmy notes",
  "_serial": 0.0,
  "_si": "googlecloud-bcone-splunk-vm\nhttp_testing",
  "_sourcetype": "googlecloud-testing",
  "_time": "2024-07-11 12:46:52.0",
  "eventtype": null,
  "host": "googlecloud-bcone-splunk-vm",
  "index": "http_testing",
  "linecount": 4.0,
  "punct": null,
  "source": "Testing.txt",
  "sourcetype": "googlecloud-testing",
  "splunk_server": "googlecloud-bcone-splunk-vm",
  "splunk_server_group": null,
  "timestamp": null,
  "JobId": "1726051471.76"
}]

Creare una ricerca utilizzando più indici

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SearchJobs dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "EventSearch": "search (index=\"http_testing\" OR index= \"googlecloud-demo\" sourcetype=\"googlecloud-testing\"  OR sourcetype=\"Demo_Text\")"
   }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività SearchJobs avrà un valore simile al seguente:

   {
   "Sid": "1727261971.4007"
   } 
   

Operazione di elenco che utilizza il nome degli indici nella query di ricerca

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Nome Index Name dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause, ad esempio Sid= '1727261971.4007'.

Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Index avrà un valore simile al seguente:

 [{
  "_bkt": "googlecloud-demo~0~D043151E-5A2D-4FAB-8647-4D5DA2F288AF",
  "_cd": "00:04:00",
  "_eventtype_color": null,
  "_indextime": 1.727155516E9,
  "_kv": null,
  "_raw": "Hi team\nwe have a demo please plan accordingly\nwith Google team",
  "_serial": 0.0,
  "_si": "googlecloud-bcone-splunk-vm\ngooglecloud-demo",
  "_sourcetype": "Demo_Text",
  "_time": "2024-09-24 05:25:16.0",
  "eventtype": null,
  "host": "googlecloud-bcone-splunk-vm",
  "index": "googlecloud-demo",
  "linecount": 3.0,
  "punct": null,
  "source": "Splunk_Demo.txt",
  "sourcetype": "Demo_Text",
  "splunk_server": "googlecloud-bcone-splunk-vm",
  "splunk_server_group": null,
  "timestamp": null,
  "JobId": "1727261971.4007"
}, {
  "_bkt": "http_testing~0~D043151E-5A2D-4FAB-8647-4D5DA2F288AF",
  "_cd": "00:04:00",
  "_eventtype_color": null,
  "_indextime": 1.720702012E9,
  "_kv": null,
  "_raw": "hi How r yo\nplease\nfind \nmy notes",
  "_serial": 1.0,
  "_si": "googlecloud-bcone-splunk-vm\nhttp_testing",
  "_sourcetype": "googlecloud-testing",
  "_time": "2024-07-11 12:46:52.0",
  "eventtype": null,
  "host": "googlecloud-bcone-splunk-vm",
  "index": "http_testing",
  "linecount": 4.0,
  "punct": null,
  "source": "Testing.txt",
  "sourcetype": "googlecloud-testing",
  "splunk_server": "googlecloud-bcone-splunk-vm",
  "splunk_server_group": null,
  "timestamp": null,
  "JobId": "1727261971.4007"
}]

Esempio: flusso di ricerca utilizzando ReadJobResults

Questa sezione elenca tutti i flussi di ricerca che utilizzano sia un singolo indice sia più indici supportati dalla connessione Splunk. Al momento,la dimensione massima del payload per i risultati dei log supportati è di 150 MB.

Crea una ricerca con un singolo indice

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SearchJobs dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "EventSearch": "search (index=\"http_testing\" sourcetype=\"googlecloud-testing\") "
   }
   

   Questo esempio crea una ricerca. Se l'integrazione va a buon fine, il parametro di risposta connectorOutputPayload dell'attività SearchJobs avrà un valore simile al seguente:

   {
   "Sid": "1732775755.24612"
   } 
   

Per ottenere i risultati di ricerca, esegui l'operazione di creazione sull'azione ReadJobResults. Per assicurarti che i risultati vengano filtrati in base all'ID sessione, trasmetti l'ID sessione come parametro all'azione.

Recuperare i log dei risultati utilizzando l'azione ReadJobResults

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ReadJobResults, quindi fai clic su Fine.
3. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "Sid": "1732775755.24612"
   }
   

Se l'azione ha esito positivo, il parametro ReadJobResults della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"_bkt": "http_testing~0~D043151E-5A2D-4FAB-8647-4D5DA2F288AF",
"_cd": "0:4",
"_indextime": "1720702012",
"_raw": "hi How r yo\nplease\nfind \nmy notes",
"_serial": "1",
"_si": "googlecloud-bcone-splunk-vm\nhttp_testing",
"_sourcetype": "googlecloud-testing",
"_time": "2024-07-11T12:46:52.000+00:00",
"host": "googlecloud-bcone-splunk-vm",
"index": "http_testing",
"linecount": "4",
"source": "Testing.txt",
"sourcetype": "googlecloud-testing",
"splunk_server": "googlecloud-bcone-splunk-vm",
"jobid": "1732775755.24612",
"sid": "1732775755.24612"
}]

Creare una ricerca con più indici

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SearchJobs dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "EventSearch": "search (index=\"http_testing\" OR index= \"googlecloud-demo\" sourcetype=\"googlecloud-testing\"  OR sourcetype=\"Demo_Text\")"
   }
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività SearchJobs avrà un valore simile al seguente:

   {
   "Sid": "1732776556.24634"
   } 
   

Per ottenere i risultati di ricerca, esegui l'operazione di creazione sull'azione ReadJobResults. Per assicurarti che i risultati vengano filtrati in base all'ID sessione, trasmetti l'ID sessione come parametro all'azione.

ResultsLogs utilizzando l'azione ReadJobResults

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ReadJobResults, quindi fai clic su Fine.
3. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "Sid": "1732776556.24634"
   }
   

Se l'azione ha esito positivo, il parametro ReadJobResults della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"_bkt": "googlecloud-demo~0~D043151E-5A2D-4FAB-8647-4D5DA2F288AF",
"_cd": "0:4",
"_indextime": "1727155516",
"_raw": "Hi team\nwe have a demo please plan accordingly\nwith Google team",
"_serial": "0",
"_si": "googlecloud-bcone-splunk-vm\googlecloud-demo",
"_sourcetype": "Demo_Text",
"_time": "2024-09-24T05:25:16.000+00:00",
"host": "googlecloud-bcone-splunk-vm",
"index": "googlecloud-demo",
"linecount": "3",
"source": "Splunk_Demo.txt",
"sourcetype": "Demo_Text",
"splunk_server": "googlecloud-bcone-splunk-vm",
"jobid": "1732776556.24634",
"sid": "1732776556.24634"
},{
"_bkt": "http_testing~0~D043151E-5A2D-4FAB-8647-4D5DA2F288AF",
"_cd": "0:4",
"_indextime": "1720702012",
"_raw": "hi How r yo\nplease\nfind \nmy notes",
"_serial": "1",
"_si": "googlecloud-bcone-splunk-vm\nhttp_testing",
"_sourcetype": "googlecloud-testing",
"_time": "2024-07-11T12:46:52.000+00:00",
"host": "googlecloud-bcone-splunk-vm",
"index": "http_testing",
"linecount": "4",
"source": "Testing.txt",
"sourcetype": "googlecloud-testing",
"splunk_server": "googlecloud-bcone-splunk-vm",
"jobid": "1732776556.24634",
"sid": "1732776556.24634"
}]

Creare connessioni utilizzando Terraform

Puoi utilizzare la risorsa Terraform per creare una nuova connessione.

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Per visualizzare un modello Terraform di esempio per la creazione della connessione, consulta Modello di esempio.

Quando crei questa connessione utilizzando Terraform, devi impostare le seguenti variabili nel file di configurazione Terraform:

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
livello di dettaglio	STRING	Falso	Livello di verbosità per la connessione, varia da 1 a 5. Un livello di dettaglio più elevato registra tutti i dettagli di comunicazione (richiesta,risposta e certificati SSL).
proxy_enabled	BOOLEANO	Falso	Seleziona questa casella di controllo per configurare un server proxy per la connessione.
proxy_auth_scheme	ENUM	Falso	Il tipo di autenticazione da utilizzare per l'autenticazione al proxy ProxyServer. I valori supportati sono: BASIC, DIGEST, NONE
proxy_user	STRING	Falso	Un nome utente da utilizzare per l'autenticazione al proxy ProxyServer.
proxy_password	SECRET	Falso	Una password da utilizzare per l'autenticazione al proxy ProxyServer.
proxy_ssltype	ENUM	Falso	Il tipo di SSL da utilizzare per la connessione al proxy ProxyServer. I valori supportati sono: AUTO, ALWAYS, NEVER, TUNNEL

Utilizzare la connessione Splunk in un'integrazione

Una volta creata la connessione, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

• Per capire come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
• Per capire come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Ricevere assistenza dalla community Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud nei forum di Cloud.

Passaggi successivi

• Scopri come sospendere e ripristinare una connessione.
• Scopri come monitorare l'utilizzo dei connettori.
• Scopri come visualizzare i log dei connettori.