：Kumpulkan log dalam mode sederhana

Prosedur

1. Masuk ke Konsol Layanan Log Sederhana.

2. Di bagian Import Data, klik Multi-line - Text Log.

   Contoh ini menunjukkan cara mengumpulkan log teks multi-baris. Jika Anda ingin mengumpulkan log teks satu baris, klik Single Line - Text Log.

3. Pilih proyek dan penyimpanan log, lalu klik Next.

4. Buat grup mesin.

   • Jika grup mesin tersedia, klik Use Existing Machine Groups.

   • Jika tidak ada grup mesin yang tersedia, lakukan langkah-langkah berikut untuk membuat grup mesin. Dalam contoh ini, Instance ECS digunakan.

     1. Pada tab ECS Instances, pilih Pilih Instance Secara Manual. Lalu, pilih instance ECS yang ingin Anda gunakan dan klik Create.

        Untuk informasi lebih lanjut, lihat Instal Logtail pada Instance ECS.

        Penting

        Jika Anda ingin mengumpulkan log dari instance ECS yang dimiliki oleh akun Alibaba Cloud lain selain Layanan Log, server di pusat data, atau server dari penyedia layanan cloud pihak ketiga, Anda harus menginstal Logtail secara manual. Untuk informasi lebih lanjut, lihat Instal Logtail pada Server Linux atau Instal Logtail pada Server Windows.

        Setelah Anda menginstal Logtail secara manual, Anda harus mengonfigurasi pengenal pengguna untuk server tersebut. Untuk informasi lebih lanjut, lihat Konfigurasikan Pengenal Pengguna.

     2. Setelah Logtail diinstal, klik Complete Installation.

     3. Di langkah Create Machine Group, konfigurasikan parameter Name dan klik Next.

        Layanan Log memungkinkan Anda membuat grup mesin berbasis alamat IP dan grup mesin berbasis pengenal kustom. Untuk informasi lebih lanjut, lihat Buat Grup Mesin Berbasis Alamat IP dan Buat Grup Mesin Berbasis Pengenal Kustom.

5. Pilih grup mesin baru dari Source Server Groups dan pindahkan grup mesin ke Applied Server Groups. Lalu, klik Next.

   Penting

   Jika Anda menerapkan grup mesin segera setelah pembuatan, status detak jantung grup mesin mungkin FAIL. Masalah ini terjadi karena grup mesin belum terhubung ke Simple Log Service. Untuk menyelesaikan masalah ini, Anda dapat mengklik Automatic Retry. Jika masalah tetap ada, lihat Apa yang harus saya lakukan jika tidak ada koneksi detak jantung yang terdeteksi pada Logtail?

6. Buat konfigurasi Logtail dan klik Next.

   

   Parameter	Deskripsi
   Nama Konfigurasi	Masukkan nama untuk konfigurasi Logtail. Nama tersebut harus unik dalam sebuah proyek. Setelah Anda membuat konfigurasi Logtail, Anda tidak dapat mengubah nama konfigurasi Logtail. Anda dapat mengklik Import Other Configuration untuk mengimpor konfigurasi Logtail yang sudah ada.
   Jalur Log	Tentukan direktori dan nama file log berdasarkan lokasi log di server. Jika Anda menentukan jalur log dalam sistem operasi Linux, jalur tersebut harus dimulai dengan garis miring (/). Contoh: /apsara/nuwa/.../app.Log. Jika Anda menentukan jalur log dalam sistem operasi Windows, jalur tersebut harus dimulai dengan huruf drive. Contoh: C:\Program Files\Intel\...\*.Log. Anda dapat menentukan direktori dan nama yang tepat. Anda juga dapat menggunakan karakter wildcard untuk menentukan direktori dan nama. Untuk informasi lebih lanjut, lihat Pencocokan wildcard. Layanan Log memindai semua tingkat direktori yang ditentukan untuk file log yang sesuai dengan kondisi tertentu. Contoh: Jika Anda menentukan /apsara/nuwa/**/*.log, Layanan Log mengumpulkan log dari file log yang namanya diakhiri dengan .log di direktori /apsara/nuwa dan subdirektori rekursif dari direktori tersebut. Jika Anda menentukan /var/logs/app_*/*.log, Layanan Log mengumpulkan log dari file log yang memenuhi kondisi berikut: Nama file diakhiri dengan .log. File disimpan di subdirektori di bawah direktori /var/logs atau di subdirektori rekursif dari subdirektori tersebut. Nama subdirektori sesuai dengan pola app_*. Jika Anda menentukan /var/log/nginx/**/access*, Layanan Log mengumpulkan log dari file log yang namanya dimulai dengan access di direktori /var/log/nginx dan subdirektori rekursif dari direktori tersebut. Catatan Saat Anda mengonfigurasi parameter ini, Anda hanya dapat menggunakan tanda bintang (*) atau tanda tanya (?) sebagai karakter wildcard. Anda dapat menggunakan tanda bintang (*) untuk mencocokkan beberapa karakter. Anda dapat menggunakan tanda tanya (?) untuk mencocokkan satu karakter.
   Daftar Hitam	Jika Anda mengaktifkan Blacklist, Anda harus mengonfigurasi daftar hitam untuk menentukan direktori atau file yang ingin Anda lewati saat Layanan Log mengumpulkan log. Anda dapat menentukan direktori dan nama file yang tepat. Anda juga dapat menggunakan karakter wildcard untuk menentukan direktori dan nama file. Contoh: Jika Anda memilih Filter by Directory dari daftar drop-down di kolom Jenis Filter dan memasukkan /home/admin/dir1 untuk Konten, semua file di direktori /home/admin/dir1 dilewati. Jika Anda memilih Filter by Directory dari daftar drop-down di kolom Jenis Filter dan memasukkan /home/admin/dir* untuk Konten, file di semua subdirektori yang namanya diawali dengan dir di direktori /home/admin/ dilewati. Jika Anda memilih Filter by Directory dari daftar drop-down di kolom Jenis Filter dan memasukkan /home/admin/*/dir untuk Konten, semua file di direktori dir di setiap subdirektori dari direktori /home/admin/ dilewati. Sebagai contoh, file di direktori /home/admin/a/dir dilewati, tetapi file di direktori /home/admin/a/b/dir tidak dilewati. Jika Anda memilih Filter by File dari daftar drop-down di kolom Jenis Filter dan memasukkan /home/admin/private*.log untuk Konten, semua file yang namanya diawali dengan private dan diakhiri dengan .log di direktori /home/admin/ dilewati. Jika Anda memilih Filter by File dari daftar drop-down di kolom Jenis Filter dan memasukkan /home/admin/private*/*_inner.log untuk Konten, semua file yang namanya diakhiri dengan _inner.log di subdirektori yang namanya diawali dengan private di direktori /home/admin/ dilewati. Sebagai contoh, file /home/admin/private/app_inner.log dilewati, tetapi file /home/admin/private/app.log tidak dilewati. Catatan Saat Anda mengonfigurasi parameter ini, Anda hanya dapat menggunakan tanda bintang (*) atau tanda tanya (?) sebagai karakter wildcard. Anda dapat menggunakan tanda bintang (*) untuk mencocokkan beberapa karakter. Anda dapat menggunakan tanda tanya (?) untuk mencocokkan satu karakter. Jika Anda menggunakan karakter wildcard untuk mengonfigurasi Log Path dan Anda ingin melewati beberapa direktori di direktori yang ditentukan, Anda harus mengonfigurasi daftar hitam dan memasukkan direktori lengkap. Sebagai contoh, jika Anda menetapkan Log Path ke /home/admin/app*/log/*.log dan Anda ingin melewati semua subdirektori di direktori /home/admin/app1*, Anda harus memilih Filter by Directory dan memasukkan /home/admin/app1*/** untuk mengonfigurasi daftar hitam. Jika Anda memasukkan /home/admin/app1*, daftar hitam tidak akan berlaku. Saat daftar hitam digunakan, overhead komputasi dihasilkan. Kami merekomendasikan Anda menambahkan hingga 10 entri ke daftar hitam. Anda tidak dapat menentukan jalur direktori yang diakhiri dengan garis miring (/). Sebagai contoh, jika Anda menetapkan jalur ke /home/admin/dir1/, daftar hitam direktori tidak akan berlaku.
   File Docker	Jika Anda ingin mengumpulkan log dari kontainer Docker, Anda harus mengaktifkan Docker File dan menentukan direktori dan tag kontainer. Logtail memantau kontainer untuk memeriksa apakah kontainer dibuat atau dihapus, menyaring kontainer berdasarkan tag, dan mengumpulkan log dari kontainer dalam hasil penyaringan. Untuk informasi lebih lanjut, lihat Gunakan konsol Layanan Log Sederhana untuk mengumpulkan log teks kontainer dalam mode DaemonSet.
   Mode	Pilih mode pengumpulan. Nilai default: Simple Mode - Multi-line. Anda dapat mengubah mode.
   Contoh Log	Masukkan contoh log yang dikumpulkan dari skenario aktual. Lalu, Layanan Log dapat secara otomatis menghasilkan ekspresi reguler untuk mencocokkan awal baris pertama log. Contoh: [2020-10-01T10:30:01,000] [INFO] java.lang.Exception: exception happened at TestPrintStackTrace.f(TestPrintStackTrace.java:3) at TestPrintStackTrace.g(TestPrintStackTrace.java:7) at TestPrintStackTrace.main(TestPrintStackTrace.java:16) Jika Anda ingin mengumpulkan log teks satu baris dalam mode sederhana, Anda tidak perlu mengonfigurasi parameter ini.
   Regex untuk Mencocokkan Baris Pertama	Konfigurasikan ekspresi reguler untuk mencocokkan awal baris pertama log. Logtail menggunakan ekspresi reguler untuk mencocokkan awal baris pertama log dan menganggap konten yang tidak cocok dengan ekspresi reguler sebagai bagian dari log. Layanan Log dapat secara otomatis menghasilkan ekspresi reguler atau menggunakan ekspresi reguler yang Anda tentukan secara manual. Pembuatan otomatis Setelah Anda memasukkan contoh log teks multi-baris, klik Auto Generate. Layanan Log secara otomatis menghasilkan ekspresi reguler untuk mencocokkan awal baris pertama log. Konfigurasi manual Setelah Anda memasukkan contoh log teks multi-baris, klik Manual dan tentukan secara manual ekspresi reguler untuk mencocokkan awal baris pertama log. Lalu, klik Validate untuk memeriksa apakah ekspresi reguler valid. Untuk informasi lebih lanjut, lihat Bagaimana cara saya menguji ekspresi reguler? Jika Anda ingin mengumpulkan log teks satu baris dalam mode sederhana, Anda tidak perlu mengonfigurasi parameter ini.
   Drop Log yang Gagal Diparsing	Tentukan apakah akan membuang log yang gagal diparsing. Jika Anda mengaktifkan Drop Failed to Parse Logs, log yang gagal diparsing tidak akan diunggah ke Layanan Log. Jika Anda menonaktifkan Drop Failed to Parse Logs, log yang gagal diparsing masih akan diunggah ke Layanan Log sebagai nilai dari bidang __raw__.
   Kedalaman Pemantauan Direktori Maksimum	Tentukan jumlah maksimum tingkat subdirektori yang ingin Anda pantau. Subdirektori tersebut berada di direktori file log yang Anda tentukan. Nilai valid: 0 hingga 1000. Nilai 0 menentukan bahwa hanya direktori file log yang Anda tentukan yang dipantau.

   Anda dapat mengonfigurasi pengaturan lanjutan berdasarkan kebutuhan bisnis Anda. Kami merekomendasikan Anda tidak mengubah pengaturan lanjutan. Tabel berikut menjelaskan parameter dalam pengaturan lanjutan.

   Parameter	Deskripsi
   Aktifkan Pemrosesan Plugin	Jika log Anda kompleks dan tidak dapat diurai dalam mode seperti mode NGINX, mode regex penuh, atau mode JSON, Anda dapat mengaktifkan Enable Plug-in Processing untuk menambahkan plugin Logtail untuk memproses log. Layanan Log menghasilkan konfigurasi plugin default berdasarkan mode pengumpulan yang Anda pilih. Anda dapat menambahkan konfigurasi plugin lain ke konfigurasi plugin default dengan mengonfigurasi bidang processor. Untuk informasi lebih lanjut, lihat Ikhtisar Plugin Logtail untuk Pemrosesan Data. Penting Jika Anda mengaktifkan Enable Plug-in Processing, parameter seperti Unggah Log Mentah, Zona Waktu, Drop Log yang Gagal Diparsing, Konfigurasi Filter, dan Unggah Entri Tidak Lengkap (mode Delimiter) menjadi tidak tersedia.
   Unggah Log Mentah	Jika Anda mengaktifkan Upload Raw Log, setiap log mentah diunggah ke Layanan Log sebagai nilai dari bidang __raw__ bersama dengan log yang diurai dari log mentah tersebut.
   Mode Pembuatan Topik	Pilih mode pembuatan topik. Untuk informasi lebih lanjut, lihat Topik Log. Null - Do not generate topic: Dalam mode ini, bidang topik disetel ke string kosong. Saat Anda menanyakan log, Anda tidak perlu menentukan topik. Ini adalah nilai default. Machine Group Topic Attributes: Dalam mode ini, topik dikonfigurasikan pada tingkat grup mesin. Jika Anda ingin membedakan log yang dihasilkan oleh server berbeda, pilih mode ini. File Path RegEx: Dalam mode ini, Anda harus menentukan ekspresi reguler di bidang Custom RegEx. Bagian jalur log yang cocok dengan ekspresi reguler digunakan sebagai topik. Jika Anda ingin membedakan log yang dihasilkan oleh pengguna atau instance berbeda, pilih mode ini.
   Pengkodean File Log	Format pengkodean file log. Nilai valid: utf8 dan gbk.
   Zona Waktu	Pilih zona waktu tempat log dikumpulkan. Nilai valid: Zona Waktu Sistem: Jika Anda memilih nilai ini, zona waktu server atau kontainer tempat Logtail diinstal digunakan. Kustom: Jika Anda memilih nilai ini, Anda harus memilih zona waktu berdasarkan kebutuhan bisnis Anda.
   Batas Waktu	Jika file log tidak diperbarui dalam periode yang ditentukan, Logtail menganggap pemantauan telah habis waktu. Tidak Pernah: Semua file log terus dipantau, dan pemantauan tidak akan habis waktu. Batas Waktu 30 Menit: Jika file log tidak diperbarui dalam 30 menit, Logtail menganggap pemantauan telah habis waktu dan tidak lagi memantau file tersebut. Jika Anda memilih 30 Minute Timeout, Anda harus mengonfigurasi parameter Maximum Timeout Directory Depth. Nilai valid: 1 hingga 3.
   Konfigurasi Filter	Tentukan kondisi filter yang ingin Anda gunakan untuk mengumpulkan log. Kondisi filter terdiri dari Key dan Regex. Key menentukan nama bidang yang diperlukan, dan Regex menentukan ekspresi reguler yang digunakan untuk penyaringan. Operator logika antara kondisi filter adalah DAN. Penting Dalam mode sederhana, hanya bidang konten yang dihasilkan. Jika Anda ingin menentukan kondisi filter, Anda dapat menyetel Key hanya ke content. Ekspresi reguler yang Anda tentukan hanya mendukung pencocokan teks lengkap. Pencocokan kata kunci tidak didukung. Contoh: Kumpulkan log yang sesuai dengan kondisi filter yang ditentukan. Jika Anda menyetel Key ke level dan menyetel Regex ke WARNING|ERROR, hanya log yang nilainya level adalah WARNING atau ERROR yang dikumpulkan. Jika Anda menyetel Key ke content dan menyetel Regex ke .*05\/Jan\/2023.*, hanya log yang nilainya konten berisi 05/Jan/2023 yang dikumpulkan. Filter keluar log yang tidak sesuai dengan kondisi filter yang ditentukan. Jika Anda menyetel Key ke level dan menyetel Regex ke ^(?!.*(INFO|DEBUG)).*, log yang nilainya level berisi INFO atau DEBUG difilter keluar. Jika Anda menyetel Key ke level dan menyetel Regex ke ^(?!(INFO|DEBUG)$).*, log yang nilainya level adalah INFO atau DEBUG difilter keluar. Jika Anda menyetel Key ke url dan menyetel Regex ke .*^(?!.*(healthcheck)).*, log yang nilainya url berisi healthcheck difilter keluar. Untuk informasi lebih lanjut tentang cara menentukan ekspresi reguler, lihat Memulai dengan ekspresi reguler.
   Ukuran Pengumpulan Pertama	Tentukan ukuran data yang dapat dikumpulkan Logtail dari file log pertama kali Logtail mengumpulkan log dari file tersebut. Nilai default Ukuran Pengumpulan Pertama adalah 1024. Unit: KB. Jika ukuran file kurang dari 1.024 KB, Logtail mengumpulkan data dari awal file. Jika ukuran file lebih besar dari 1.024 KB, Logtail mengumpulkan 1.024 KB data terakhir di file tersebut. Anda dapat menentukan First Collection Size berdasarkan kebutuhan bisnis Anda. Nilai valid: 0 hingga 10485760. Unit: KB.
   Konfigurasi Lainnya	Tentukan pengaturan tambahan untuk Logtail. Untuk informasi lebih lanjut, lihat lanjutan. Sebagai contoh, jika Anda ingin menggunakan konfigurasi Logtail saat ini untuk mengumpulkan log dari file log yang sesuai dengan konfigurasi Logtail berbeda dan menentukan interval log diagregasi dan dikirim ke Layanan Log, Anda dapat menentukan pengaturan tambahan untuk Logtail saat ini. { "force_multiconfig": true, "batch_send_interval": 3 }

   Klik Next untuk menyelesaikan pembuatan konfigurasi Logtail. Lalu, Layanan Log mulai mengumpulkan log.

   Catatan

   • Konfigurasi Logtail memerlukan hingga 3 menit untuk berlaku.

   • Jika terjadi kesalahan saat menggunakan Logtail untuk mengumpulkan log, lihat Bagaimana cara saya melihat kesalahan pengumpulan Logtail? dan Bagaimana cara saya menyelesaikan kesalahan umum yang mungkin terjadi saat Layanan Log Sederhana mengumpulkan log?

7. Pratinjau data, konfigurasikan indeks, lalu klik Next.

   Secara default, pengindeksan teks lengkap diaktifkan untuk Layanan Log. Anda juga dapat mengonfigurasi indeks bidang berdasarkan log yang dikumpulkan dalam mode manual atau otomatis. Untuk mengonfigurasi indeks bidang dalam mode otomatis, klik Automatic Index Generation. Dengan cara ini, Layanan Log secara otomatis membuat indeks bidang. Untuk informasi lebih lanjut, lihat Buat Indeks.

   Penting

   Jika Anda ingin menanyakan dan menganalisis log, Anda harus mengaktifkan pengindeksan teks lengkap atau pengindeksan bidang. Jika Anda mengaktifkan kedua pengindeksan teks lengkap dan pengindeksan bidang, sistem hanya menggunakan indeks bidang.

8. Klik Log Query. Anda akan dialihkan ke halaman query dan analisis Logstore Anda.

   Anda harus menunggu sekitar 1 menit agar indeks berlaku. Lalu, Anda dapat melihat log yang dikumpulkan di tab Raw Logs. Untuk informasi lebih lanjut, lihat Panduan Query dan Analisis Log.

Pemecahan Masalah

Jika tidak ada data yang ditampilkan di halaman pratinjau atau halaman query setelah log dikumpulkan menggunakan Logtail, Anda dapat menyelesaikan kesalahan berdasarkan instruksi yang diberikan dalam Apa yang harus saya lakukan jika kesalahan terjadi saat saya menggunakan Logtail untuk mengumpulkan log?