Agen Logging melakukan streaming log dari instance VM Anda dan dari paket software pihak ketiga tertentu ke Cloud Logging. Praktik terbaiknya adalah menjalankan agen Logging di semua instance VM Anda.
Image VM untuk Compute Engine dan Amazon Elastic Compute Cloud (EC2) tidak menyertakan agen Logging, jadi Anda harus menyelesaikan langkah-langkah berikut untuk menginstalnya pada instance tersebut. Agen ini berjalan di Linux dan Windows.
Jika VM Anda berjalan di Google Kubernetes Engine atau App Engine, agen sudah disertakan dalam image VM, sehingga Anda dapat melewati halaman ini.
Sebelum memulai
Untuk menginstal agen, pastikan Anda memiliki hal berikut:
Instance VM yang didukung di project Google Cloud atau akun Amazon Web Services (AWS).
- Saat menginstal agen Logging, diperlukan memori minimum 250 MiB, tetapi sebaiknya gunakan 1 GiB.
Selain itu, pastikan VM Anda menjalankan sistem operasi yang didukung.
Kredensial pada instance VM yang mengizinkan komunikasi dengan Cloud Logging atau Cloud Monitoring. Secara default, instance VM Compute Engine memiliki kredensial yang benar. Jika salah satu skenario berikut berlaku untuk Anda, Anda mungkin tidak memiliki kredensial yang tepat dan harus menyelesaikan prosedur Otorisasikan agen Logging:
Dengan menjalankan instance VM AWS EC2, Anda harus menginstal kredensial otorisasi di VM sebelum menginstal agen.
Menjalankan instance Compute Engine lama atau instance Compute Engine yang dibuat tanpa kredensial default.
Untuk memeriksa apakah Anda memiliki kredensial yang tepat, jalankan prosedur Memverifikasi kredensial Compute Engine.
Untuk pengguna AWS, lakukan hal berikut:
Hubungkan akun AWS Anda ke Google Cloud. Untuk mengetahui informasi tentang proses ini, lihat Mengumpulkan metrik dari akun AWS.
Lihat bagian Project Google Cloud untuk instance VM AWS EC2 untuk mengetahui informasi tambahan.
Untuk mengetahui informasi harga, buka Harga untuk Kemampuan Observasi Google Cloud.
Jika Anda menggunakan VM yang tidak memiliki akses ke repositori paket jarak jauh, lihat bagian VM tanpa akses paket jarak jauh untuk mengetahui informasi selengkapnya.
Menginstal agen dari command line
Untuk menginstal agen menggunakan command line, gunakan petunjuk berikut.
Instal agen versi terbaru
Untuk menginstal agen versi terbaru, selesaikan langkah-langkah berikut.
Linux
Buka koneksi terminal ke instance VM Anda menggunakan SSH atau alat serupa, dan pastikan Anda memiliki akses
sudo
.Ubah ke direktori yang akses tulisnya Anda miliki, misalnya direktori home Anda.
Download dan jalankan skrip penginstalan agen dengan menggunakan perintah berikut:
curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh sudo bash add-logging-agent-repo.sh --also-install
Setelah diinstal, agen akan otomatis dimulai.
Windows
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell yang menggunakan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.
Jalankan perintah PowerShell berikut:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe") & "${env:UserProfile}\StackdriverLogging-v1-21.exe"
Menginstal versi agen tertentu
Untuk menginstal versi agen tertentu, selesaikan langkah-langkah berikut.
Linux
Buka koneksi terminal ke instance VM Anda menggunakan SSH atau alat serupa, dan pastikan Anda memiliki akses
sudo
.Ubah ke direktori yang akses tulisnya Anda miliki, misalnya direktori home Anda.
Download skrip penginstalan agen:
curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
Saat menjalankan skrip
add-logging-agent-repo.sh
, Anda juga dapat menetapkan tanda berikut:--verbose
: Mengaktifkan logging panjang selama eksekusi skrip.--also-install
: Menginstal agen setelah menambahkan repositori paket agen.--version
: Menetapkan versi agen untuk skrip yang akan diinstal. Untuk mengetahui informasi versi, lihat Mencantumkan semua versi agen.--uninstall
: Meng-uninstal agen.--remove-repo
: Menghapus repositori paket agen yang sesuai setelah menginstal atau meng-uninstal agen.--dry-run
: Hanya memicu uji coba eksekusi skrip dan mencetak perintah yang seharusnya dijalankan.
Lihat komentar skrip untuk informasi lebih lanjut dan contoh penggunaannya.
Tambahkan repositori paket agen dan instal agen:
Untuk mencantumkan versi agen yang tersedia, lihat Mencantumkan semua versi agen.
Untuk lingkungan produksi, Anda dapat menyematkan ke versi utama untuk menghindari penginstalan versi utama yang mungkin menyertakan perubahan yang tidak kompatibel dengan versi sebelumnya. Untuk menyematkan ke versi utama, jalankan:
sudo bash add-logging-agent-repo.sh --also-install \ --version=MAJOR_VERSION.*.*
Misalnya, untuk menyematkan ke 1.x.x agen, jalankan:
sudo bash add-logging-agent-repo.sh --also-install \ --version=1.*.*
Untuk menginstal versi agen tertentu, jalankan:
sudo bash add-logging-agent-repo.sh --also-install \ --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
Memulai ulang layanan agen
Mulai ulang diperlukan agar konfigurasi yang diinstal oleh paket generik di atas dapat diterapkan.
sudo service google-fluentd restart
Anda dapat menghapus skrip penginstalan setelah berhasil dijalankan.
Untuk memverifikasi bahwa agen berfungsi seperti yang diharapkan, jalankan:
sudo service google-fluentd status
Status agen seharusnya Oke.
Anda juga dapat memeriksa log dan memastikan tidak ada error:
tail /var/log/google-fluentd/google-fluentd.log
Jika Anda mengalami masalah saat penginstalan, lihat halaman Pemecahan masalah.
Windows
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell yang menggunakan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.
Jalankan perintah PowerShell berikut:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe") & "${env:UserProfile}\StackdriverLogging-v1-21.exe"
Atau, Anda dapat menjelajahi URL berikut untuk mendownload dan menjalankan penginstal agen:
https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-21.exe
Untuk menginstal agen secara otomatis, tambahkan opsi
/S
ke pemanggilan penginstal:& "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S
Dalam mode "silent", gunakan opsi
/D
untuk menentukan direktori penginstalan, misalnya:& "${env:UserProfile}\StackdriverLogging-v1-21.exe" /S /D="C:\Stackdriver\Logging\"
Anda dapat menghapus penginstal jika berhasil diselesaikan.
Jika Anda mengalami masalah saat penginstalan, lihat halaman Pemecahan masalah.
Melihat informasi agen dengan menggunakan Konsol Google Cloud
Anda dapat menemukan informasi status tentang agen di dasbor VM Instances Monitoring yang telah dikonfigurasi sebelumnya. Untuk membuka dasbor ini, lakukan tindakan berikut:
Di panel navigasi konsol Google Cloud, pilih Monitoring, pilih Dashboards, lalu pilih VM instances:
Tampilan List di tab Inventory di dasbor mencantumkan semua VM dan menyertakan kolom status untuk agen Anda, seperti yang ditunjukkan pada screenshot berikut:
Kolom Agen melaporkan nilai berikut:
Tidak terdeteksi: Anda tidak menginstal agen atau agen tersebut tidak berjalan. Jika tidak yakin apakah Anda telah menginstal agen, Anda dapat melakukan kueri untuk versi yang diinstal. Jika telah menginstal agen, Anda dapat memulai ulang agen.
Agen Operasional: Anda menjalankan Agen Operasional. Jika Anda tidak melihat tanda centang hijau di samping entri, berarti ada upgrade agen yang tersedia, berdasarkan sistem operasi yang terdeteksi di VM Anda.
Saat mengarahkan kursor ke indikator Agen Operasional di tabel, Anda akan melihat informasi tentang versi Agen Operasional. Jika menjalankan versi yang lebih lama, Anda juga akan melihat rekomendasi untuk mengupgrade agen.
Tertunda: Agen Operasional sedang diinstal atau diupgrade.
Agen Lama: Anda menjalankan agen Monitoring atau Logging lama. Lihat Bermigrasi dari agen lama ke Agen Operasi untuk mengetahui informasi tentang transisi ke Agen Operasional.
Tidak berlaku: VM ini bukan platform yang didukung untuk menjalankan agen.
Tidak diketahui: VM tidak berjalan, sehingga status agen tidak diketahui.
Anda dapat menginstal Agen Operasional dengan melakukan hal berikut:
- Pilih instance VM tempat Anda ingin menginstal agen.
- Klik opsi Install/Update Ops Agent pada tabel Instances.
Anda juga dapat menginstal atau memperbarui Agen Operasional dari halaman VM Details untuk VM tertentu.
Jika memungkinkan, agen akan diinstal menggunakan kebijakan OS Agen Operasional. Untuk mengetahui informasi selengkapnya, lihat Mengelola VM yang dicakup oleh kebijakan OS Agen Operasional. Kebijakan OS Agen Operasional tidak didukung di semua versi semua sistem operasi. Dalam hal ini, mengklik Install/Update Ops Agent akan memberikan serangkaian perintah untuk dijalankan di Cloud Shell.
Agen Operasional mengumpulkan metrik dan log secara default. Anda dapat mengubah perilaku default ini dengan mengonfigurasi Agen Operasional.
Tugas opsional
Bagian ini menjelaskan cara melakukan tugas pemeliharaan umum.
Aktifkan logging terstruktur
Saat Anda menjalankan skrip penginstalan di VM Linux, skrip secara default
akan menginstal paket google-fluentd-catch-all
saat tanda --also-install
ada. Untuk beralih ke logging terstruktur, selesaikan langkah-langkah
berikut.
Cadangkan semua perubahan lokal ke
/etc/google-fluentd/config.d/
.Jalankan salah satu perintah berikut, bergantung pada distribusi Linux Anda:
YUM:
sudo yum remove -y google-fluentd-catch-all-config sudo yum install -y google-fluentd-catch-all-config-structured sudo service google-fluentd restart
APT:
sudo apt-get remove -y google-fluentd-catch-all-config sudo apt-get install -y google-fluentd-catch-all-config-structured sudo service google-fluentd restart
Untuk informasi tentang logging terstruktur, lihat panduan logging terstruktur.
Mengonfigurasi agen Logging
Agen telah dikonfigurasi sebelumnya untuk memantau lokasi log tertentu yang diketahui. Di Linux,
lokasi tersebut dijelaskan dalam google-fluentd-catch-all-config
paket,
yang otomatis ditarik oleh skrip penginstalan. Di Windows, agen memantau Windows Event Log secara default.
Untuk menyesuaikan konfigurasi agen, lihat Mengonfigurasi Agen logging.
Mengonfigurasi Proxy HTTP
Jika Anda menggunakan proxy HTTP untuk membuat proxy permintaan ke Logging and Monitoring API, lakukan hal berikut:
Linux
Edit file konfigurasi berikut (buat file jika belum ada):
/etc/default/google-fluentd
Tambahkan kode berikut ke file:
export http_proxy="http://proxy-ip:proxy-port" export https_proxy="http://proxy-ip:proxy-port" export no_proxy=169.254.169.254 # Skip proxy for the local Metadata Server.
Mulai ulang agen dengan menjalankan perintah berikut pada instance VM Anda:
sudo service google-fluentd restart
Windows
Jika Anda menggunakan proxy HTTP, jalankan perintah berikut dari command prompt administrator. Tindakan ini akan menetapkan variabel lingkungan
http_proxy
danhttps_proxy
sehingga agen dapat mengirim data menggunakan HTTPS keluar:setx http_proxy http://proxy-ip:proxy-port /m setx https_proxy http://proxy-ip:proxy-port /m setx no_proxy 169.254.169.254 /m
Menentukan versi agen
Untuk menentukan versi agen Logging pada sistem Anda, jalankan perintah berikut pada instance VM Anda:
AMAZON LINUX AMI / CENTOS / RHEL
Jalankan perintah berikut di Amazon Linux, Red Hat, atau CentOS Linux:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured
DEBIAN / UBUNTU
Jalankan perintah berikut di Debian atau Ubuntu:
dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured
SLES / SUSE
Jalankan perintah berikut di SUSE:
rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured
WINDOWS
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell yang menggunakan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.
Jalankan perintah PowerShell berikut:
reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version
Memulai ulang agen
Anda harus memulai ulang agen Logging untuk mengambil perubahan pada file konfigurasi. Untuk memulai ulang agen, gunakan petunjuk berikut.
LINUX
Jalankan perintah berikut pada instance Anda:
sudo service google-fluentd restart
Setelah memulai ulang agen Logging, sebaiknya Anda mengirim pesan pengujian.
Windows
Hubungkan ke instance Anda menggunakan RDP atau alat serupa, lalu login ke Windows.
Buka terminal PowerShell yang menggunakan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator.
Jalankan perintah PowerShell berikut:
Restart-Service -Name StackdriverLogging
Mengupgrade agen
Untuk mengupgrade agen Logging ke rilis terbaru, gunakan petunjuk berikut:
Linux
Untuk mengupgrade agen ke versi terbaru, jalankan perintah berikut:
sudo bash add-logging-agent-repo.sh --also-install
Untuk mengupgrade agen ke rilis titik terbaru dari versi utama tertentu, jalankan perintah berikut:
sudo bash add-logging-agent-repo.sh --also-install \
--version=MAJOR_VERSION.*.*
Windows
Untuk mengupgrade ke rilis agen terbaru, instal agen terbaru seperti yang dijelaskan dalam Menginstal di Windows di halaman ini. Penginstal akan meminta Anda untuk meng-uninstal agen versi sebelumnya.
Mencantumkan semua versi agen
Untuk menampilkan versi agen yang tersedia, jalankan perintah berikut:
AMAZON LINUX AMI / CENTOS / RHEL
Cantumkan versi agen yang tersedia:
sudo yum list --showduplicates google-fluentd
DEBIAN / UBUNTU
Cantumkan versi agen yang tersedia:
sudo apt-cache madison google-fluentd
SLES / SUSE
Cantumkan versi agen yang tersedia:
sudo zypper search -s google-fluentd
WINDOWS
Menginstal versi agen sebelumnya di Windows tidak didukung.
Meng-uninstal agen
Untuk menghapus agen Logging dan file konfigurasinya, gunakan petunjuk berikut.
Setelah Anda meng-uninstal agen, Konsol Google Cloud mungkin memerlukan waktu hingga satu jam untuk melaporkan perubahan ini.
Linux
Jalankan perintah berikut:
sudo bash add-logging-agent-repo.sh --uninstall
Secara opsional, untuk menghapus repositori selain meng-uninstal agen,
tambahkan --remove-repo
ke perintah sebelumnya.
Windows
Di Control Panel Windows, pilih Uninstall a program. Anda akan melihat
Agen logging dalam daftar program yang dapat di-uninstal. Anda juga dapat
menjalankan uninstall.exe
dari direktori tempat Anda menginstal
agen Logging.
Informasi tentang project Google Cloud untuk instance VM AWS EC2
Jika dokumentasinya merujuk ke project Google Cloud yang terkait dengan instance VM Anda, untuk instance VM EC2, frasa ini mengacu pada project AWS Connector yang ditautkan ke akun AWS Anda.
Saat menghubungkan akun AWS ke Google Cloud, Anda akan membuat project AWS Connector. Untuk mengetahui informasi tentang proses ini, lihat artikel Mengumpulkan metrik dari akun AWS.
Untuk mengakses project AWS Connector untuk akun AWS, lakukan salah satu hal berikut:
Gunakan pemilih project konsol Google Cloud untuk mengidentifikasi project yang cocok dengan konvensi penamaan project AWS Connector Anda, lalu pilih project spesifik untuk akun AWS Anda.
Identifikasi project Google Cloud yang cakupan metriknya mencakup metrik akun AWS Anda dan pilih project tersebut di pemilih project konsol Google Cloud. Untuk project Google Cloud ini, buka halaman Monitoring lalu pilih halaman Settings. Halaman Settings mencantumkan project AWS Connector. Anda dapat menggunakan pemilih project konsol Google Cloud untuk mengakses project AWS Connector.
VM tanpa akses paket jarak jauh
Menginstal agen Logging memerlukan akses ke repositori paket jarak jauh, untuk paket agen dan (di Linux) dependensinya.
Jika Anda menggunakan VPC-SC atau jaringan pribadi, konfigurasi jaringan juga dapat memengaruhi kemampuan Anda untuk menginstal dependensi agen dari repositori upstream. Paket agen itu sendiri dapat diakses menggunakan Akses Google Pribadi. Opsi ini dapat dikonfigurasi dengan mengikuti Mengaktifkan Akses Google Pribadi.
Jika kebijakan keamanan host VM Anda menolak akses ke repositori paket jarak jauh, sebaiknya buat image VM kustom dengan agen yang telah diinstal sebelumnya dan nonaktifkan pengelolaan paket dalam image tersebut.
Langkah selanjutnya
Pelajari log yang dikirim agen ke Cloud Logging menggunakan konfigurasi defaultnya.
Untuk informasi tentang cara melihat log, lihat Menggunakan Logs Explorer.