Menyiapkan Cloud Logging untuk PHP

Anda dapat menulis log ke Cloud Logging dari aplikasi PHP menggunakan library Cloud Logging untuk PHP secara langsung.

Sebelum memulai

  1. Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Logging API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Logging API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

Menginstal library Cloud Logging untuk PHP

PSR-3

Untuk menulis log dari aplikasi Anda, tambahkan library Cloud Logging untuk PHP ke composer.json Anda:

composer require google/cloud-logging

Membuat logger PSR-3

Gunakan kode berikut untuk membuat logger PSR-3:

use Google\Cloud\Logging\LoggingClient;
 
$logging = new LoggingClient([
    'projectId' => $projectId
]);
$logger = $logging->psrLogger('app');

Mengaktifkan opsi batching

Logger PSR-3 mengirim log secara sinkron. Artinya, setiap kali Anda mengirim log, log tersebut akan menambahkan latensi RPC ke permintaan pengguna. Terutama jika Anda mengirim beberapa log dalam satu permintaan, latensi yang ditambahkan akan signifikan. Sebaiknya hindari hal tersebut.

Kode berikut membuat logger PSR-3 yang akan mengelompokkan beberapa log ke dalam satu panggilan RPC:

$logger = LoggingClient::psrBatchLogger('app');

Secara default, logger ini mengelompokkan log dalam satu proses. Di lingkungan fleksibel App Engine, Anda dapat mengonfigurasi library Cloud Logging untuk PHP agar memiliki throughput yang lebih tinggi dan latensi yang lebih rendah. Untuk mengetahui detailnya, lihat Mengonfigurasi daemon logging.

Mengonfigurasi library Cloud Logging untuk PHP

Anda dapat menyesuaikan perilaku library Cloud Logging untuk PHP. Lihat dokumen konfigurasi untuk mengetahui daftar opsi konfigurasi yang mungkin.

Menggunakan logger PSR-3

Setelah logger dibuat, Anda dapat menggunakan logger di aplikasi Anda:

$logger->info('Hello World');
$logger->error('Oh no');

Untuk mengetahui informasi selengkapnya tentang penginstalan, lihat dokumentasi untuk library Cloud Logging untuk PHP. Anda juga dapat melaporkan masalah menggunakan pelacak masalah .

Menulis log dengan library klien Cloud Logging

Untuk mengetahui informasi tentang cara menggunakan library klien Cloud Logging untuk PHP secara langsung, lihat Library Klien Cloud Logging.

Menjalankan di Google Cloud

Agar aplikasi dapat menulis log menggunakan library Cloud Logging untuk PHP, akun layanan untuk resource yang mendasarinya harus memiliki peran IAM Penulis Log (roles/logging.logWriter) . Sebagian besar Google Cloud lingkungan otomatis mengonfigurasi akun layanan default agar memiliki peran ini.

App Engine

Cloud Logging otomatis diaktifkan untuk App Engine, dan akun layanan default aplikasi Anda memiliki izin IAM secara default untuk menulis entri log.

Untuk mengetahui informasi selengkapnya, lihat Menulis dan melihat log.

Namun, sebaiknya gunakan logger PSR-3 yang otomatis menambahkan metadata ke log Anda sehingga log aplikasi Anda dikorelasikan dengan log permintaan.

Mengonfigurasi daemon untuk lingkungan fleksibel App Engine

Di lingkungan fleksibel App Engine, Anda dapat mengonfigurasi library Cloud Logging untuk PHP agar menggunakan program daemon eksternal untuk memaksimalkan throughput log dan meminimalkan latensi aplikasi. Untuk mengaktifkan fitur ini, tambahkan baris berikut ke bagian runtime_config di app.yaml:

enable_stackdriver_integration: true

Google Kubernetes Engine (GKE)

GKE otomatis memberikan peran IAM Penulis Log (roles/logging.logWriter) kepada akun layanan default. Jika Anda menggunakan Workload Identity Federation for GKE dengan akun layanan default ini agar workload dapat mengakses Google Cloud API tertentu, tidak diperlukan konfigurasi tambahan. Namun, jika Anda menggunakan Workload Identity Federation for GKE dengan akun layanan IAM kustom, pastikan akun layanan kustom tersebut memiliki peran Penulis Log (roles/logging.logWriter).

Jika diperlukan, Anda juga dapat menggunakan perintah berikut untuk menambahkan cakupan akses logging.write saat membuat cluster:

gcloud container clusters create example-cluster-name \
    --scopes https://www.googleapis.com/auth/logging.write

Compute Engine

Saat menggunakan Compute Engine instance VM, tambahkan cloud-platform cakupan akses ke setiap instance. Saat membuat instance baru melalui Google Cloud konsol, Anda dapat melakukannya di bagian Identity and API access pada panel Create Instance. Gunakan akun layanan default Compute Engine atau akun layanan lain pilihan Anda, lalu pilih Allow full access to all Cloud APIs di bagian Identity and API access. Akun layanan mana pun yang Anda pilih, pastikan akun tersebut telah diberi peranPenulis Log di bagian IAM & Admin di konsol.Google Cloud

Menjalankan secara lokal dan di tempat lain

Untuk menggunakan library Cloud Logging untuk PHP di luar Google Cloud, termasuk menjalankan library di workstation Anda sendiri, di komputer pusat data Anda, atau di instance VM penyedia cloud lain, Anda harus menyiapkan Kredensial Default Aplikasi (ADC) di lingkungan lokal Anda untuk melakukan autentikasi ke library Cloud Logging untuk PHP.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan lokal atau penyedia cloud lainnya.

Melihat log

Di Google Cloud konsol, buka halaman Logs Explorer:

Buka Logs Explorer

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

Di Logs Explorer, Anda harus menentukan satu atau beberapa resource, tetapi pemilihan resource mungkin tidak jelas. Berikut beberapa tips yang dapat membantu Anda memulai:

Untuk mengetahui informasi tambahan, lihat Menggunakan Logs Explorer.