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à.
Per facilitare il debug dei problemi relativi all'accesso dei client all'API, è possibile registrare i log delle chiamate API su Amazon Data Firehose. Per ulteriori informazioni su Firehose, consulta What Is Amazon Data Firehose?
Per la registrazione degli accessi, puoi solo abilitare CloudWatch o FireHose, non puoi abilitare entrambi. Tuttavia, è possibile abilitare CloudWatch la registrazione dell'esecuzione e Firehose la registrazione degli accessi.
Argomenti
Formati di log di Firehose per Gateway API
La registrazione Firehose utilizza lo stesso formato della registrazione. CloudWatch
Autorizzazioni per la registrazione dei log di Firehose
Quando la registrazione dei log degli accessi di Firehose è abilitata su una fase, Gateway API crea nell'account un ruolo collegato al servizio, se non è già esistente. Il ruolo è denominato AWSServiceRoleForAPIGateway ed è collegato alla policy gestita APIGatewayServiceRolePolicy. Per ulteriori informazioni sui ruoli collegati ai servizi, consulta Utilizzo dei ruoli collegati ai servizi.
Nota
Il nome del flusso di Firehose deve essere amazon-apigateway-.{your-stream-name}
Configurazione della registrazione dei log degli accessi di Firehose tramite la console Gateway API
Per configurare la registrazione API, devi aver distribuito l'API in una fase. È inoltre necessario aver creato un flusso di Firehose.
Accedi alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.
-
Esegui una di queste operazioni:
-
Seleziona un'API esistente e quindi scegli una fase.
-
Crea un'API e distribuiscila in una fase.
-
Nel riquadro di navigazione principale scegli Fasi.
-
Nella sezione Log e tracciamento scegli Modifica.
-
Per abilitare la registrazione dei log degli accessi in un flusso Firehose:
-
Attiva Registrazione accesso personalizzato.
-
In ARN di destinazione del log degli accessi inserisci l'ARN di un flusso Firehose. Il formato dell'ARN è
arn:aws:firehose:.{region}:{account-id}:deliverystream/amazon-apigateway-{your-stream-name}Nota
Il nome del flusso di Firehose deve essere
amazon-apigateway-.{your-stream-name} -
In Formato dei log immetti un formato di log. Puoi scegliere CLF, JSON, XML o CSV. Per ulteriori informazioni sui formati di log di esempio, consulta CloudWatch formati di registro per API Gateway.
-
-
Scegli Save changes (Salva modifiche).
Gateway API è ora pronto per registrare i log delle richieste all'API su Firehose. Non è necessario ridistribuire l'API quando si aggiornano le impostazioni delle fasi, i log o le variabili delle fasi.
