Registra le chiamate API REST su Amazon Data Firehose in API Gateway

Per risolvere i problemi relativi all'accesso dei client alla tua API, puoi registrare le 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.

Formati di registro Firehose per API Gateway

La registrazione di Firehose utilizza lo stesso formato della registrazione. CloudWatch

Autorizzazioni per la registrazione di Firehose

Quando la registrazione degli accessi Firehose è abilitata su uno stage, API Gateway crea un ruolo collegato al servizio nell'account, se il ruolo non esiste già. 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 dello stream Firehose deve essere. amazon-apigateway-{your-stream-name}

Configurare la registrazione degli accessi Firehose utilizzando la console API Gateway

Per configurare la registrazione API, devi aver distribuito l'API in una fase. È inoltre necessario aver creato uno stream Firehose.

1. Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

2. Esegui una di queste operazioni:

   1. Seleziona un'API esistente e quindi scegli una fase.

   2. Crea un'API e distribuiscila in una fase.

3. Nel riquadro di navigazione principale scegli Fasi.

4. Nella sezione Log e tracciamento scegli Modifica.

5. Per abilitare la registrazione degli accessi a uno stream Firehose:

   1. Attiva Registrazione accesso personalizzato.

   2. Per l'ARN di destinazione del registro di accesso, immettete l'ARN di uno stream Firehose. Il formato dell'ARN è arn:aws:firehose:{region}:{account-id}:deliverystream/amazon-apigateway-{your-stream-name}.

      Nota

      Il nome dello stream Firehose deve essere. amazon-apigateway-{your-stream-name}

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

6. Seleziona Salvataggio delle modifiche.

API Gateway è ora pronto per registrare le richieste nella tua API su Firehose. Non è necessario ridistribuire l'API quando si aggiornano le impostazioni delle fasi, i log o le variabili delle fasi.