Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Log panggilan REST API ke Amazon Data Firehose di API Gateway
<a name="apigateway-logging-to-kinesis"></a>

Untuk membantu masalah debug yang terkait dengan akses klien ke API Anda, Anda dapat mencatat panggilan API ke Amazon Data Firehose. Untuk informasi selengkapnya tentang Firehose, lihat [Apa itu Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html)? .

Untuk pencatatan akses, Anda hanya dapat mengaktifkan CloudWatch atau Firehose—Anda tidak dapat mengaktifkan keduanya. Namun, Anda dapat mengaktifkan CloudWatch pencatatan eksekusi dan Firehose untuk pencatatan akses.

**Topics**
+ [Format log Firehose untuk API Gateway](#apigateway-kinesis-log-formats)
+ [Izin untuk pencatatan Firehose](#set-up-kinesis-access-logging-permissions)
+ [Mengatur pencatatan akses Firehose dengan menggunakan konsol API Gateway](#set-up-kinesis-access-logging-using-console)

## Format log Firehose untuk API Gateway
<a name="apigateway-kinesis-log-formats"></a>

[Firehose logging menggunakan format yang sama dengan logging. CloudWatch ](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-logging.html)

## Izin untuk pencatatan Firehose
<a name="set-up-kinesis-access-logging-permissions"></a>

Saat pencatatan akses Firehose diaktifkan di panggung, API Gateway akan membuat peran terkait layanan di akun Anda jika peran tersebut belum ada. Peran tersebut dinamai `AWSServiceRoleForAPIGateway` dan memiliki kebijakan `APIGatewayServiceRolePolicy` terkelola yang melekat padanya. Untuk informasi selengkapnya tentang peran terkait layanan, lihat [Menggunakan Peran Tertaut Layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html).

**catatan**  
Nama aliran Firehose Anda harus. `amazon-apigateway-{your-stream-name}`

## Mengatur pencatatan akses Firehose dengan menggunakan konsol API Gateway
<a name="set-up-kinesis-access-logging-using-console"></a>

Untuk menyiapkan pencatatan API, Anda harus menerapkan API ke sebuah panggung. Anda juga harus membuat aliran Firehose. 

1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).

1.  Lakukan salah satu tindakan berikut:

   1.  Pilih API yang ada, lalu pilih panggung.

   1.  Buat API dan terapkan ke panggung.

1. Di panel navigasi utama, pilih **Tahapan**.

1.  Di bagian **Log dan penelusuran**, pilih **Edit**.

1. Untuk mengaktifkan pencatatan akses ke aliran Firehose:

   1. Aktifkan **Pencatatan akses khusus**.

   1. Untuk **akses log tujuan ARN**, masukkan ARN dari aliran Firehose. Format ARN adalah. `arn:aws:firehose:{region}:{account-id}:deliverystream/amazon-apigateway-{your-stream-name}`
**catatan**  
Nama aliran Firehose Anda harus. `amazon-apigateway-{your-stream-name}`

   1. Untuk **format Log**, masukkan format log. **Anda dapat memilih **CLF**, **JSON**, **XHTML**, atau CSV.** Untuk mempelajari lebih lanjut tentang contoh format log, lihat[CloudWatch format log untuk API Gateway](set-up-logging.md#apigateway-cloudwatch-log-formats).

1. Pilih **Simpan perubahan**.

API Gateway sekarang siap untuk mencatat permintaan ke API Anda ke Firehose. Anda tidak perlu menerapkan ulang API saat memperbarui pengaturan panggung, log, atau variabel tahap.