

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à.

# Connessione a Splunk
<a name="connecting-telemetry-sources-connecting-splunk"></a>

## Built-in, integrazione unidirezionale
<a name="built-in-1-way-integration"></a>

Attualmente, AWS DevOps Agent supporta gli utenti Splunk con un'integrazione unidirezionale integrata, che consente quanto segue:
+ **Attivazione automatica delle indagini**: gli eventi Splunk possono essere configurati per attivare le indagini sulla risoluzione degli incidenti degli AWS DevOps agenti tramite i webhook degli agenti. AWS DevOps 
+ **Introspezione telemetrica: l' AWS DevOps agente può analizzare la telemetria** di Splunk mentre analizza un problema tramite il server MCP remoto di ciascun provider.

## Prerequisiti
<a name="prerequisites"></a>

### Ottenere un token API Splunk
<a name="getting-a-splunk-api-token"></a>

Avrai bisogno di un URL e di un token MCP per connettere Splunk.

### Procedura dell'amministratore di Splunk
<a name="splunk-administrator-steps"></a>

L'amministratore Splunk deve eseguire le seguenti operazioni:
+ abilitare l'accesso all'[API REST](https://docs.splunk.com/Documentation/SplunkCloud/latest/RESTTUT/RESTandCloud)
+ [abilita l'autenticazione tramite token](https://help.splunk.com/en/splunk-cloud-platform/administer/manage-users-and-security/9.2.2406/authenticate-into-the-splunk-platform-with-tokens/enable-or-disable-token-authentication) sulla distribuzione.
+ crea un nuovo ruolo 'mcp\_user', il nuovo ruolo non deve avere alcuna funzionalità.
+ assegna il ruolo 'mcp\_user' a tutti gli utenti della distribuzione autorizzati a utilizzare il server MCP.
+ crea il token per gli utenti autorizzati con audience come 'mcp' e imposta la scadenza appropriata, se l'utente non ha l'autorizzazione per creare i token da solo.

### Procedure per utenti Splunk
<a name="splunk-user-steps"></a>

Un utente Splunk deve eseguire i seguenti passaggi:
+ Ottieni un token appropriato dall'amministratore Splunk o creane uno lui stesso, se ne ha l'autorizzazione. Il pubblico per il token deve essere 'mcp'.

## Onboarding
<a name="onboarding"></a>

### Fase 1: Connect
<a name="step-1-connect"></a>

Stabilisci la connessione all'endpoint MCP remoto Splunk con le credenziali di accesso all'account

#### Configurazione
<a name="configuration"></a>

1. Vai alla pagina **Capability Provider** (accessibile dalla barra di navigazione laterale)

1. **Trova **Splunk** nella sezione Provider **disponibili** sotto **Telemetria** e clicca su Registra**

1. Inserisci i dettagli del tuo server MCP Splunk:
   + **Nome del server**: identificatore univoco (ad es. my-splunk-server)
   + **URL dell'endpoint - L'endpoint del server** Splunk MCP:

`https://<YOUR_SPLUNK_DEPLOYMENT_NAME>.api.scs.splunk.com/<YOUR_SPLUNK_DEPLOYMENT_NAME>/mcp/v1/`
+ **Descrizione: descrizione opzionale del server**
+ **Nome token**: il nome del token portatore per l'autenticazione: `my-splunk-token`
+ Valore del **token - Il valore** del token portatore per l'autenticazione

### Fase 2: Abilita
<a name="step-2-enable"></a>

Attiva Splunk in uno spazio specifico dell'agente e configura l'ambito appropriato

#### Configurazione
<a name="configuration"></a>

1. Dalla pagina Agent Space, seleziona uno spazio agente e premi Visualizza dettagli (se non hai ancora creato uno spazio agente, consulta) [Creazione di uno spazio per agenti](getting-started-with-aws-devops-agent-creating-an-agent-space.md)

1. Seleziona la scheda Funzionalità

1. Scorri verso il basso fino alla sezione Telemetria

1. Premi Aggiungi

1. Seleziona Splunk

1. Next

1. Rivedi e premi Salva

1. Copia l'URL del Webhook e la chiave API

### Fase 3: Configurare i webhook
<a name="step-3-configure-webhooks"></a>

Utilizzando l'URL e la chiave API del Webhook, puoi configurare Splunk per inviare eventi per avviare un'indagine, ad esempio a partire da un allarme.

I webhook Splunk utilizzano l'autenticazione con token bearer. Per il formato completo di richiesta dei webhook, lo schema di payload e il codice di esempio, consulta. [Richiamo DevOps dell'agente tramite Webhook](configuring-capabilities-for-aws-devops-agent-invoking-devops-agent-through-webhook.md) Utilizza gli esempi della versione 2 (autenticazione con token Bearer), impostando l'`Authorization: Bearer <Token>`intestazione con la chiave API del passaggio 2.

Invia webhook con Splunk [https://help.splunk.com/en/splunk-enterprise/alert-and-respond/alerting-manual/9.4/configure-alert-actions/use-a-webhook-alert-action](https://help.splunk.com/en/splunk-enterprise/alert-and-respond/alerting-manual/9.4/configure-alert-actions/use-a-webhook-alert-action)(nota: seleziona nessuna autorizzazione e usa invece l'opzione di intestazione personalizzata)

### Ulteriori informazioni:
<a name="learn-more"></a>
+ Documentazione del server MCP di Splunk: [https://help.splunk.com/en/splunk-cloud-platform/mcp-server-for-splunk-platform/about-mcp-server-for-splunk-platform](https://help.splunk.com/en/splunk-cloud-platform/mcp-server-for-splunk-platform/about-mcp-server-for-splunk-platform)
+ Requisiti e limitazioni di accesso per l'API REST di Splunk Cloud Platform: [https://docs.splunk.com/Documentation/SplunkCloud/latest/RESTTUT/RESTandCloud](https://docs.splunk.com/Documentation/SplunkCloud/latest/RESTTUT/RESTandCloud)
+ Gestisci i token di autenticazione nella piattaforma Splunk Cloud: [https://help.splunk.com/en/splunk-cloud-platform/administer/manage-users-and-security/9.3.2411/authenticate-into-the-splunk-platform-with-tokens/manage-or-delete-authentication-tokens](https://help.splunk.com/en/splunk-cloud-platform/administer/manage-users-and-security/9.3.2411/authenticate-into-the-splunk-platform-with-tokens/manage-or-delete-authentication-tokens)
+ Crea e gestisci ruoli con Splunk Web: [https://docs.splunk.com/Documentation/SplunkCloud/latest/Security/Addandeditroles](https://docs.splunk.com/Documentation/SplunkCloud/latest/Security/Addandeditroles)

## Rimozione
<a name="removal"></a>

La fonte di telemetria è connessa a due livelli a livello di spazio dell'agente e a livello di account. Per rimuoverla completamente, è necessario prima rimuoverla da tutti gli spazi dell'agente in cui viene utilizzata, dopodiché può essere annullata la registrazione.

### Fase 1: Rimuovi dallo spazio dell'agente
<a name="step-1-remove-from-agent-space"></a>

1. Dalla pagina degli spazi per gli agenti, seleziona uno spazio agente e premi Visualizza dettagli

1. Seleziona la scheda Funzionalità

1. Scorri verso il basso fino alla sezione Telemetria

1. Seleziona Splunk

1. Premi rimuovi

### Fase 2: Annullare la registrazione dall'account
<a name="step-2-deregister-from-account"></a>

1. Vai alla pagina dei **Capability Provider** (accessibile dalla barra di navigazione laterale)

1. Scorri fino alla sezione **Attualmente registrato**. 

1. Verifica che il numero di spazi per gli agenti sia pari a zero (in caso contrario, ripeti il passaggio 1 precedente negli altri spazi riservati agli agenti) 

1. Premi Annulla registrazione accanto a Splunk