# Attiva i messaggi di debug
<a name="gateway-debug-messages"></a>

Mentre il gateway è in fase di sviluppo, puoi attivare i messaggi di debug per restituire dettagli sui problemi di configurazione di destinazione, inclusi errori della funzione lambda, errori dell'autorizzazione in uscita, errori di convalida dei parametri di specificazione del target. Dopo aver attivato i messaggi di debug, se si verifica un problema quando richiami il gateway, la risposta restituirà messaggi per aiutarti a eseguire il debug.

 **Per attivare i messaggi di debug, esegui una delle seguenti operazioni:** 
+ Se si utilizza la AgentCore CLI per creare un gateway, il debug viene attivato automaticamente.
+ Se si utilizza la console di AWS gestione per creare un gateway, il debug è attivato per impostazione predefinita. **L'opzione si trova in **Configurazioni aggiuntive** nella sezione Dettagli del gateway.**
+ Se utilizzi la AWS CLI o un AWS SDK, imposta il `exceptionLevel` valore come `DEBUG` quando effettui una [CreateGateway](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateGateway.html)richiesta or. [UpdateGateway](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_UpdateGateway.html)

Al termine del debug del gateway, puoi aggiornare il gateway per disattivare i messaggi di debug, in modo che il messaggio all'utente finale mostri solo un errore interno non specificato.

 **Per disattivare i messaggi di debug, esegui una delle seguenti operazioni:** 
+ **Nella console di AWS gestione, espandi **Configurazioni aggiuntive** nella sezione **Dettagli del gateway** quando crei o modifichi un gateway e deseleziona la casella di controllo accanto a Debug a livello di eccezione.**
+ Nella AWS CLI o in un AWS SDK, ometti il `exceptionLevel` campo quando effettui una `UpdateGateway` richiesta `CreateGateway` o richiedi di disattivare il debug.

## Esempi di risposte del gateway con debug attivato e disattivato
<a name="gateway-building-debug-ex"></a>

Ad esempio, supponiamo che l'utente non disponga delle autorizzazioni per richiamare una funzione Lambda destinata al gateway. Una richiesta che richiama questa funzione restituirebbe un messaggio diverso a seconda che il debug sia attivato o disattivato:
+  **Debug attivato**: un messaggio di errore dettagliato verrà restituito nel `text` campo del contenuto e anche nel `_meta` campo della risposta, come nell'esempio seguente:

  ```
  {
    "jsonrpc": "2.0",
    "id": 24,
    "result": {
      "content": [
        {
          "type": "text",
          "text": "Access denied while invoking Lambda function arn:aws:lambda:us-west-2:123456789012:function:TestGatewayLambda. Check the permissions on the Lambda function and Gateway execution role, and retry the request."
        }
      ],
      "_meta": {
        "debug": {
          "type": "text",
          "text": "Access denied while invoking Lambda function arn:aws:lambda:us-west-2:123456789012:function:TestGatewayLambda. Check the permissions on the Lambda function and Gateway execution role, and retry the request."
        }
      },
      "isError": true
    }
  }
  ```
+  **Debug disattivato**: nella risposta verrebbe restituito un messaggio di errore generico nel `text` campo del contenuto, come nell'esempio seguente:

  ```
  {
    "jsonrpc": "2.0",
    "id": 24,
    "result": {
      "content": [
        {
          "type": "text",
          "text": "An internal error occurred. Please retry later."
        }
      ],
      "isError": true
    }
  }
  ```