Splunk

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

Dans cette section, vous trouverez la liste des actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action CreateHTTPEvent

Cette action permet d'envoyer des événements d'application et de données à un déploiement Splunk avec les protocoles HTTP et HTTPS.

Paramètres d'entrée de l'action CreateHTTPEvent

Paramètres de sortie de l'action CreateHTTPEvent

Cette action renvoie l'état de réussite de l'événement créé.

Action CreateIndex

Cette action permet de créer des index.

Paramètres d'entrée de l'action CreateIndex

Paramètres de sortie de l'action CreateIndex

Cette action renvoie le message de confirmation de l'action CreateIndex.

Pour savoir comment configurer l'action CreateIndex, consultez Exemples d'actions.

Action CreateSavedSearch

Cette action permet d'enregistrer vos recherches.

Paramètres d'entrée de l'action CreateSavedSearch

Paramètres de sortie de l'action CreateSavedSearch

Cette action renvoie le message de confirmation de l'action CreateSavedSearch.

Pour savoir comment configurer l'action CreateSavedSearch, consultez Exemples d'actions.

Action UpdateSavedSearch

Cette action permet de mettre à jour une recherche enregistrée.

Paramètres d'entrée de l'action UpdateSavedSearch

Paramètres de sortie de l'action UpdateSavedSearch

Cette action renvoie le message de confirmation de l'action UpdateSavedSearch.

Pour savoir comment configurer l'action UpdateSavedSearch, consultez Exemples d'actions.

Action DeleteIndex

Cette action permet de supprimer un index.

Paramètres d'entrée de l'action DeleteIndex

Paramètres de sortie de l'action DeleteIndex

Cette action renvoie le message de confirmation de l'action DeleteIndex.

Pour savoir comment configurer l'action DeleteIndex, consultez Exemples d'actions.

Action UpdateIndex

Cette action permet de mettre à jour un index.

Paramètres d'entrée de l'action UpdateIndex

Paramètres de sortie de l'action UpdateIndex

Cette action renvoie le message de confirmation de l'action UpdateIndex.

Pour savoir comment configurer l'action UpdateIndex, consultez Exemples d'actions.

Exemples d'actions

Exemple : Créer un événement HTTP

Cet exemple crée un événement HTTP.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateHTTPEvent, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateHTTPEvent aura une valeur semblable à la suivante :

[{
"Success": "Success"
}] 

Exemple : Créer un index

Cet exemple crée un index.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateIndex, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Name": "http_testing"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateIndex aura une valeur semblable à la suivante :

[{
"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,
}]

Exemple : Créer une recherche enregistrée

Cet exemple crée une recherche enregistrée.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateSavedSearch, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateSavedSearch aura une valeur semblable à la suivante :

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

Exemple : Mettre à jour une recherche enregistrée

Cet exemple met à jour une recherche enregistrée.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action UpdateSavedSearch, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UpdateSavedSearch aura une valeur semblable à la suivante :

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

Exemple : Supprimer un index

Cet exemple supprime un index.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DeleteIndex, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Name": "g_http_testing"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DeleteIndex aura une valeur semblable à la suivante :

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

Exemple : Mettre à jour un index

Cet exemple met à jour un index.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action UpdateIndex, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UpdateIndex aura une valeur semblable à la suivante :

[{
"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
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister tous les enregistrements

Cet exemple liste tous les enregistrements de l'entité SearchJobs.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SearchJobs dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. (Facultatif) Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez filtrer votre ensemble de résultats en spécifiant une clause de filtre. Indiquez toujours la valeur de la clause de filtre entre guillemets simples (').

Exemple : Récupérer un enregistrement à partir d'une entité

Cet exemple récupère un enregistrement ayant l'ID spécifié à partir de l'entité SearchJobs.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SearchJobs dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 1698309163.1300 dans le champ Valeur par défaut.

   Ici, 1698309163.1300 est un ID d'enregistrement unique dans l'entité SearchJobs.

Exemple : Créer un enregistrement dans une entité

Cet exemple crée un enregistrement dans l'entité SearchJobs.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SearchJobs dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable 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" 
   } 
   

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche SearchJobs aura une valeur semblable à la suivante :

   {
   "Sid": "1699336785.1919"
   } 
   

Exemple : Créer un enregistrement dans une entité

Cet exemple crée un enregistrement dans l'entité DataModels.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez DataModels dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ 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\":\"\"}"
   }

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   [{
   "Id": "Test1"
   }]

Exemple : Supprimer un enregistrement d'une entité

Cet exemple supprime l'enregistrement ayant l'ID spécifié dans l'entité DataModels.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez DataModels dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez Test1 dans le champ Valeur par défaut.

Exemple : Mettre à jour un enregistrement dans une entité

Cet exemple met à jour un enregistrement dans l'entité DataModels.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez DataModels dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ 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. Cliquez sur entityId, puis saisissez /servicesNS/nobody/search/datamodel/model/Testing dans le champ Valeur par défaut.

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemple : Flux de recherche utilisant un index

Dans cette section, vous trouverez la liste de tous les flux de recherche utilisant un index unique et plusieurs index.

Créer une recherche à l'aide d'un index unique

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SearchJobs dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche SearchJobs aura une valeur semblable à la suivante :

   {
   "Sid": "1726051471.76"
   } 
   

Opération List utilisant le nom d'index indiqué dans la requête de recherche

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Index Name dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause, par exemple Sid= '1726051471.76'.

Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Index Name aura une valeur semblable à la suivante :

[{
  "_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"
}]

Créer une recherche à l'aide de plusieurs index

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SearchJobs dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche SearchJobs aura une valeur semblable à la suivante :

   {
   "Sid": "1727261971.4007"
   } 
   

Opération List utilisant les noms d'index indiqués dans la requête de recherche

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Index Name dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause, par exemple Sid= '1727261971.4007'.

Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Index aura une valeur semblable à la suivante :

 [{
  "_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"
}]

Exemple : Flux de recherche utilisant des ReadJobResults

Dans cette section, vous trouverez la liste de tous les flux de recherche qui utilisent à la fois un index unique et plusieurs index compatibles avec la connexion Splunk. Actuellement, la taille maximale de la charge utile pour les résultats de journal compatibles est de 150 Mo.

Créer une recherche avec un index unique

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SearchJobs dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable locale.

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

   Cet exemple crée une recherche. Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche SearchJobs aura une valeur semblable à la suivante :

   {
   "Sid": "1732775755.24612"
   } 
   

Pour obtenir les résultats de la recherche, effectuez l'opération Create sur l'action ReadJobResults. Pour vous assurer que les résultats sont filtrés en fonction du SID, transmettez-le en tant que paramètre à l'action.

Récupérer des journaux de résultats à l'aide de l'action ReadJobResults

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ReadJobResults, puis cliquez sur OK.
3. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable locale.

   {
   "Sid": "1732775755.24612"
   }
   

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ReadJobResults aura une valeur semblable à la suivante :

[{
"_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"
}]

Créer une recherche avec plusieurs index

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez SearchJobs dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche SearchJobs aura une valeur semblable à la suivante :

   {
   "Sid": "1732776556.24634"
   } 
   

Pour obtenir les résultats de la recherche, effectuez l'opération Create sur l'action ReadJobResults. Pour vous assurer que les résultats sont filtrés en fonction du SID, transmettez-le en tant que paramètre à l'action.

ResultsLogs à l'aide de l'action ReadJobResults

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ReadJobResults, puis cliquez sur OK.
3. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable locale.

   {
   "Sid": "1732776556.24634"
   }
   

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ReadJobResults aura une valeur semblable à la suivante :

[{
"_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"
}]

Utiliser Terraform pour créer des connexions

Vous pouvez utiliser la ressource Terraform pour créer une connexion.

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

Pour afficher un exemple de modèle Terraform permettant de créer une connexion, consultez Exemple de modèle.

Lorsque vous créez cette connexion à l'aide de Terraform, vous devez définir les variables suivantes dans votre fichier de configuration Terraform :

Nom du paramètre	Type de données	Obligatoire	Description
verbosity	STRING	False	Niveau de verbosité de la connexion, compris entre 1 et 5. Un niveau de verbosité plus élevé consigne tous les détails de la communication (requête, réponse et certificats SSL).
proxy_enabled	BOOLEAN	False	Cochez cette case afin de configurer un serveur proxy pour la connexion.
proxy_auth_scheme	ENUM	False	Type d'authentification à utiliser pour s'authentifier auprès du proxy ProxyServer. Valeurs acceptées : BASIC, DIGEST et NONE.
proxy_user	STRING	False	Nom d'utilisateur permettant de s'authentifier auprès du proxy ProxyServer.
proxy_password	SECRET	False	Mot de passe à utiliser pour s'authentifier auprès du proxy ProxyServer.
proxy_ssltype	ENUM	False	Type SSL à utiliser lors de la connexion au proxy ProxyServer. Valeurs acceptées : AUTO, ALWAYS, NEVER et TUNNEL.

Utiliser la connexion Splunk dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

• Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez Tâche "Connecteurs".
• Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".

Demander de l'aide à la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étapes suivantes

• Découvrez comment suspendre et reprendre une connexion.
• Découvrez comment surveiller l'utilisation des connecteurs.
• Découvrez comment afficher les journaux des connecteurs.