Melihat log instance

Halaman ini menjelaskan cara menggunakan Cloud Logging untuk melihat dan membuat kueri log untuk instance Cloud SQL Anda.

Cloud Logging otomatis mengumpulkan data log dari instance Cloud SQL Anda. Anda dapat menggunakan Logging untuk membuat kueri, melihat, dan menganalisis data log guna membantu memecahkan masalah dan meningkatkan kemampuan observasi. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Cloud Logging dan tinjau contoh kueri Cloud SQL.

Sebelum memulai

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan Logs Explorer guna melihat entri log, minta administrator untuk memberi Anda peran IAM berikut:

  • Untuk melihat entri log di bucket _Required dan entri log dalam tampilan _Default di bucket _Default, atau untuk memilih cakupan log: Logs Viewer (roles/logging.viewer) di project, folder, atau organisasi Anda.
  • Untuk melihat semua entri log di bucket _Required dan _Default: Private Logs Viewer (roles/logging.privateLogViewer) di project, folder, atau organisasi Anda.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Melihat log

Untuk melihat entri log untuk instance Cloud SQL Anda, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Cloud Logging.

    Buka Cloud Logging

  2. Pilih project Cloud SQL.
  3. Di panel Query, buat pilihan berikut:
    • All resources: pilih Cloud SQL Database. Pada dialog, pilih instance Cloud SQL.
    • Semua nama log: buka bagian Cloud SQL dan pilih file log yang sesuai untuk instance Anda. Contoh:
      • cloudsql.googleapis.com/sqlagent.out
      • cloudsql.googleapis.com/sqlserver.err
    • Semua tingkat keseriusan: pilih tingkat keseriusan. Misalnya, pilih Error untuk melihat log dengan tingkat keparahan minimal Error.
    • Pemilih rentang waktu: pilih opsi waktu preset, tentukan waktu mulai dan waktu berakhir kustom, atau pusatkan rentang waktu di sekitar stempel waktu tertentu.

gcloud

Gunakan perintah gcloud logging untuk melihat entri log. Pada contoh di bawah, ganti PROJECT_ID. Flag limit adalah parameter opsional yang menunjukkan jumlah entri maksimum yang akan ditampilkan.

gcloud logging read "resource.type=cloudsql_database" \
--project=PROJECT-ID \
--limit=10 \
--format=json

Lihat log operasi instance

Anda dapat melihat log untuk instance di panel Operasi. Panel Operasi mencatat setiap operasi yang dilakukan pada instance ke dalam log dengan informasi berikut:

  • Saat operasi selesai, dilaporkan dalam zona waktu lokal Anda.
  • Jenis operasi.
  • Status operasi.
  • Pesan yang menjelaskan hasil operasi.

Jika operasi gagal, Anda dapat menggunakan pesan untuk memecahkan masalah.

Untuk melihat log operasi instance:

  1. Di konsol Google Cloud , buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Buka panel Operations and logs untuk melihat log operasi.
Catatan: Log operasi tidak menyertakan operasi yang dilakukan menggunakan Management Tools eksternal, seperti alat command line SQL Server. Hanya operasi pengelolaan pengguna dan perubahan sandi yang dilakukan menggunakan konsolGoogle Cloud , gcloud CLI, atau Cloud SQL Admin API yang muncul di log operasi.

Lihat log aplikasi

Aplikasi yang terhubung ke Cloud SQL menyimpan log-nya di berbagai lokasi.

Lingkungan fleksibel App Engine

Untuk melihat log layanan App Engine Anda, lakukan hal berikut:

  1. Buka halaman Services App Engine di konsol Google Cloud :

    Buka Layanan

  2. Pilih layanan dari tabel, lalu klik Logs di kolom Diagnose.

    Anda akan dialihkan ke Logs Explorer dengan kueri yang mengambil log untuk layanan App Engine Anda.

Untuk melihat log App Engine di bagian Logs Explorer di konsolGoogle Cloud , gunakan kueri seperti berikut:

resource.type="gae_app"
resource.labels.module_id="default"

Cloud Run

Untuk melihat log Cloud Run di bagian Logs Explorer pada konsolGoogle Cloud , gunakan kueri seperti berikut:

resource.type="cloud_run_revision"
resource.labels.service_name="$SERVICE_NAME"
resource.labels.revision_name="$REVISION_NAME"

Perhatikan bahwa Cloud Run hanya melaporkan pesan error dari Proxy Auth Cloud SQL.

Proxy Auth Cloud SQL

Untuk melihat log Proxy Auth Cloud SQL di bagian Logs Explorer pada konsolGoogle Cloud , gunakan kueri seperti berikut:

log_id("appengine.googleapis.com/cloud-sql-proxy")

Lihat log audit

Cloud SQL menulis Cloud Audit Logs untuk mencatat aktivitas administratif dan akses data di seluruh resource Anda. Anda dapat melihat jenis log audit berikut untuk instance Cloud SQL Anda:

  • Aktivitas Admin: entri log yang ditulis oleh panggilan API yang dilakukan pengguna atau tindakan lain yang mengubah konfigurasi atau metadata resource. Anda tidak dapat menonaktifkan log ini.
  • Akses Data: entri log yang ditulis oleh panggilan API yang membaca konfigurasi atau metadata resource. Log ini juga mencakup operasi yang membaca atau menulis data yang disediakan pengguna. Untuk menulis log audit Akses Data, Anda harus mengaktifkannya.
  • Peristiwa Sistem: entri log yang ditulis oleh agen layanan terkelola dan sistem Google Cloud yang mengubah konfigurasi resource. Anda tidak dapat menonaktifkan log ini.

Untuk mengetahui informasi selengkapnya tentang cara melihat log audit Cloud SQL, termasuk daftar lengkap metode yang diaudit, lihat Logging audit Cloud SQL untuk SQL Server.

Harga

Untuk mengetahui informasi selengkapnya tentang harga Cloud Logging, lihat Ringkasan harga Cloud Logging.

Memecahkan masalah

Masalah Pemecahan masalah
Log audit tidak ditemukan. Log Akses Data hanya ditulis jika operasi merupakan panggilan API berbasis pengguna yang diautentikasi yang membuat, mengubah, atau membaca data yang dibuat pengguna, atau jika operasi mengakses file konfigurasi atau metadata resource.
Informasi operasi tidak ditemukan dalam log. Anda ingin menemukan informasi selengkapnya tentang suatu operasi.

Misalnya, pengguna telah dihapus tetapi Anda tidak dapat mengetahui siapa yang melakukannya. Log menunjukkan operasi dimulai tetapi tidak memberikan informasi lebih lanjut. Anda harus mengaktifkan logging audit agar informasi identitas pribadi (PII) yang mendetail seperti ini dapat dicatat ke dalam log.
Beberapa log difilter dari log error.log instance Cloud SQL untuk SQL Server. Log yang difilter menyertakan log AD tanpa stempel waktu, dan menyertakan: Login failed for user 'x'. Reason: Token-based server access validation failed with an infrastructure error. Login lacks connect endpoint permission. [CLIENT: 127.0.0.1]. Log ini difilter karena berpotensi menyebabkan kebingungan.
File log sulit dibaca. Anda lebih suka melihat log sebagai json atau teks.Anda dapat menggunakan perintah gcloud logging read bersama dengan perintah pasca-pemrosesan linux untuk mendownload log.

Untuk mendownload log sebagai JSON:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json

Untuk mendownload log sebagai TEXT:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt