sam logs

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)sam logs.

Untuk pengantar AWS SAMCLI, lihatApa itu AWS SAMCLI?.

sam logsPerintah mengambil log yang dihasilkan oleh AWS Lambda fungsi Anda.

Penggunaan

$ sam logs <options>

Opsi

--config-env TEXT

Nama lingkungan yang menentukan nilai parameter default dalam file konfigurasi yang akan digunakan. Nilai default-nya adalah “default”. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi.

--config-file PATH

Jalur dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan. Nilai default-nya adalah “samconfig.toml” di root direktori proyek. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi.

--cw-log-group LIST

Termasuk log dari grup CloudWatch log Log yang Anda tentukan. Jika Anda menentukan opsi ini bersama denganname, AWS SAM termasuk log dari grup log yang ditentukan selain log dari sumber daya bernama.

--debug

Mengaktifkan logging debug untuk mencetak pesan debug yang dihasilkan oleh AWS SAMCLI dan menampilkan stempel waktu.

---end-time, e TEXT

Mengambil log sampai saat ini. Waktu dapat berupa nilai-nilai relatif seperti '5 menit yang lalu', 'besok', atau stempel waktu yang diformat seperti '01-01-2018 10.10.10'.

--filter TEXT

Memungkinkan Anda menentukan ekspresi untuk menemukan log yang cocok dengan istilah, frasa, atau nilai-nilai dalam peristiwa log Anda dengan cepat. Ini bisa berupa kata kunci sederhana (misalnya, “error”) atau pola yang didukung oleh Amazon CloudWatch Logs. Untuk sintaksnya, lihat dokumentasi Amazon CloudWatch Logs.

--help

Menunjukkan pesan ini dan keluar.

--include-traces

Termasuk jejak X-Ray dalam output log.

--name, -n TEXT

Nama sumber daya untuk mengambil log. Jika sumber daya ini adalah bagian dari AWS CloudFormation tumpukan, ini bisa menjadi ID logis dari sumber daya fungsi di AWS SAM template AWS CloudFormation/. Beberapa nama dapat diberikan dengan mengulangi parameter lagi. Jika sumber daya berada dalam tumpukan bersarang, nama dapat ditambahkan dengan nama nama tumpukan bersarang untuk menarik log dari sumber daya tersebut (/). NestedStackLogicalId ResourceLogicalId Jika nama sumber daya tidak diberikan, tumpukan yang diberikan akan dipindai dan informasi log akan ditarik untuk semua sumber daya yang didukung. Jika Anda tidak menentukan opsi ini, AWS SAM mengambil log untuk semua sumber daya di tumpukan yang Anda tentukan. Jenis sumber daya berikut didukung:

• AWS::Serverless::Function

• AWS::Lambda::Function

• AWS::Serverless::Api

• AWS::ApiGateway::RestApi

• AWS::Serverless::HttpApi

• AWS::ApiGatewayV2::Api

• AWS::Serverless::StateMachine

• AWS::StepFunctions::StateMachine

--output TEXT

Menentukan format output untuk log. Untuk mencetak log yang diformat, tentukantext. Untuk mencetak log sebagai JSON, tentukanjson.

--profile TEXT

Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

--region TEXT

AWS Wilayah untuk dikerahkan ke. Misalnya, us-east-1.

--save-params

Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

--stack-name TEXT

Nama AWS CloudFormation tumpukan yang merupakan bagian dari sumber daya.

--start-time, -s TEXT

Mengambil log mulai saat ini. Waktu dapat berupa nilai-nilai relatif seperti '5 menit lalu', 'kemarin', atau stempel waktu yang diformat seperti '01-01-2018 10.10.10'. Default ke '10 menit yang lalu'.

--tail, -t

Mengikuti output log. Ini mengabaikan argumen waktu akhir dan terus mengambil log setelah log tersedia.

Contoh

Ketika fungsi Anda adalah bagian dari AWS CloudFormation tumpukan, Anda dapat mengambil log dengan menggunakan ID logis fungsi saat Anda menentukan nama tumpukan.

$ sam logs -n HelloWorldFunction --stack-name myStack

Lihat log untuk rentang waktu tertentu menggunakan opsi -s (--start-time) dan -e (--end-time).

$ sam logs -n HelloWorldFunction --stack-name myStack -s '10min ago' -e '2min ago'

Anda juga dapat menambahkan --tail opsi untuk menunggu log baru dan melihatnya saat mereka tiba.

$ sam logs -n HelloWorldFunction --stack-name myStack --tail

Gunakan --filter opsi untuk menemukan log yang cocok dengan istilah, frasa, atau nilai dengan cepat dalam peristiwa log Anda.

$ sam logs -n HelloWorldFunction --stack-name myStack --filter "error"

Lihat log untuk sumber daya di tumpukan anak.

$ sam logs --stack-name myStack -n childStack/HelloWorldFunction

Log ekor untuk semua sumber daya yang didukung dalam aplikasi Anda.

$ sam logs --stack-name sam-app --tail

Ambil log untuk fungsi Lambda tertentu dan API Gateway API di aplikasi Anda.

$ sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi

Ambil log untuk semua sumber daya yang didukung dalam aplikasi Anda, dan juga dari grup log yang ditentukan.

$ sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456