File konfigurasi Logtail dan file rekaman -

Topik ini menjelaskan file konfigurasi dasar dan file rekaman dari Logtail. Saat Logtail aktif, ia menggunakan file konfigurasi dan menghasilkan file rekaman.

File konfigurasi startup (ilogtail_config.json)

File ilogtail_config.json digunakan untuk mengonfigurasi parameter startup Logtail dalam format JSON. Untuk informasi lebih lanjut, lihat Konfigurasikan Parameter Startup Logtail.

Penting

File ini harus berupa file JSON yang valid. Jika tidak, Logtail tidak dapat dimulai.
Jika Anda memodifikasi file ini, Anda harus me-restart Logtail agar perubahan berlaku. Untuk informasi lebih lanjut, lihat Restart Logtail.
Secara default, Logtail menggunakan protokol HTTP untuk berkomunikasi dengan server pada control plane dan data plane, serta menggunakan protokol HTTPS untuk autentikasi dengan server.
- Untuk memastikan keamanan, Anda dapat menggunakan protokol HTTPS untuk berkomunikasi dengan server. Dalam hal ini, Anda harus menyetel parameter eksplisit config_server_address dan data_server_list.endpoint menjadi https.
- Jika Anda menggunakan HTTPS untuk mentransmisikan data, latensi transmisi akan meningkat. Kami merekomendasikan penggunaan HTTPS hanya dalam skenario yang diperlukan.

Setelah Logtail diinstal pada server, Anda dapat melakukan operasi berikut dalam file ilogtail_config.json:

Modifikasi parameter runtime Logtail.
Periksa apakah perintah instalasi sesuai dengan kebutuhan Anda.
Nilai parameter config_server_address dan data_server_list dalam file ilogtail_config.json bervariasi berdasarkan perintah instalasi yang dipilih. Jika wilayah dalam perintah instalasi berbeda dari wilayah tempat Simple Log Service proyek berada atau alamat dalam perintah tidak dapat diakses, maka perintah instalasi yang Anda pilih tidak sesuai dengan kebutuhan Anda. Dalam hal ini, Logtail tidak dapat mengumpulkan log dan harus diinstal ulang.

Path File

Lingkungan Host

Sistem operasi	Logtail	Path ke file ilogtail_config.json
Linux	Logtail (64-bit)	/usr/local/ilogtail/ilogtail_config.json
Windows 64-bit	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json
Windows 64-bit	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json Catatan Anda dapat menjalankan aplikasi 32-bit dan 64-bit di Windows 64-bit. Untuk memastikan kompatibilitas, sistem operasi menyimpan aplikasi 32-bit di direktori x86 terpisah.
Windows 32-bit	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

Lingkungan Kontainer
File ilogtail_config.json disimpan dalam kontainer Logtail. Path file ditentukan dalam variabel lingkungan ALIYUN_LOGTAIL_CONFIG dari kontainer Logtail. Anda dapat menjalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_CONFIG untuk melihat path file. Contoh: /etc/ilogtail/conf/cn-hangzhou/ilogtail_config.json.

Contoh File

$cat /usr/local/ilogtail/ilogtail_config.json
{
    "config_server_address" : "http://logtail.cn-hangzhou-intranet.log.aliyuncs.com",
    "data_server_list" :
    [
        {
            "cluster" : "cn-hangzhou",
            "endpoint" : "cn-hangzhou-intranet.log.aliyuncs.com"
        }
    ],
    "cpu_usage_limit" : 0.4,
    "mem_usage_limit" : 100,
    "max_bytes_per_sec" : 2097152,
    "process_thread_count" : 1,
    "send_request_concurrency" : 4,
    "streamlog_open" : false
}

File pengenal pengguna

File pengenal pengguna berisi ID akun Alibaba Cloud Anda. File ini menentukan bahwa akun tersebut berwenang untuk mengakses server tempat Logtail diinstal dan mengumpulkan log dari server tersebut. Untuk informasi lebih lanjut, lihat Konfigurasikan Pengenal Pengguna.

Penting

Jika Anda ingin mengumpulkan log dari instance Elastic Compute Service (ECS) yang dimiliki oleh akun Alibaba Cloud lain, server yang ditempatkan di pusat data mandiri, atau server yang disediakan oleh penyedia layanan cloud pihak ketiga, Anda harus mengonfigurasi pengenal pengguna untuk server Anda.
Anda harus menentukan ID akun Alibaba Cloud sebagai pengenal pengguna dalam file pengenal pengguna. Anda tidak dapat menentukan ID Pengguna Resource Access Management (RAM) sebagai pengenal pengguna.
Anda harus menentukan nama file pengenal pengguna. Anda tidak perlu menentukan ekstensi file.
Anda dapat menentukan beberapa pengenal pengguna untuk satu server. Namun, Anda hanya dapat menentukan satu pengenal pengguna untuk satu kontainer Logtail.

Path File
- Lingkungan Host
  - Linux: /etc/ilogtail/users/
  - Windows: C:\LogtailData\users\
- Lingkungan Kontainer
  File disimpan dalam kontainer Logtail. Path file ditentukan dalam variabel lingkungan ALIYUN_LOGTAIL_USER_ID dari kontainer Logtail. Anda dapat menjalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_ID untuk melihat path file.
Contoh File
```
$ls /etc/ilogtail/users/
```

File pengenal kustom (user_defined_id)

File user_defined_id digunakan untuk mengonfigurasi pengenal kustom. Untuk informasi lebih lanjut, lihat Buat Grup Mesin Berbasis Pengenal Kustom.

Penting

Saat membuat grup mesin berbasis pengenal kustom, Anda harus mengonfigurasi file user_defined_id.

Path File
- Lingkungan Host
  - Linux: /etc/ilogtail/user_defined_id
  - Windows: C:\LogtailData\user_defined_id
- Lingkungan Kontainer
  File disimpan dalam kontainer Logtail. Path file ditentukan dalam variabel lingkungan ALIYUN_LOGTAIL_USER_DEFINED_ID dari kontainer Logtail. Anda dapat menjalankan perintah docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID untuk melihat path file.

Contoh File

$cat /etc/ilogtail/user_defined_id
aliyun-ecs-rs1e16355

File konfigurasi Logtail (user_log_config.json)

File user_log_config.json mencatat informasi tentang konfigurasi Logtail yang diterima oleh Logtail dari Simple Log Service. File ini dalam format JSON dan diperbarui bersama dengan pembaruan konfigurasi. Anda dapat menggunakan file user_log_config.json untuk memeriksa apakah konfigurasi Logtail dikirimkan ke server tempat Logtail diinstal. Jika file konfigurasi Logtail ada dan konfigurasi dalam file sama dengan pengaturan konfigurasi Logtail di Simple Log Service, konfigurasi Logtail dikirimkan.

Penting

Kami merekomendasikan Anda untuk tidak memodifikasi file konfigurasi Logtail kecuali Anda perlu menentukan informasi sensitif, seperti pasangan AccessKey dan kata sandi database Anda.

Path File

Lingkungan Host

Sistem operasi	Logtail	Path ke file user_log_config.json
Linux	Logtail (64-bit)	/usr/local/ilogtail/user_log_config.json
Windows 64-bit	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\user_log_config.json
Windows 64-bit	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\user_log_config.json Catatan Anda dapat menjalankan aplikasi 32-bit dan 64-bit di Windows 64-bit. Untuk memastikan kompatibilitas, sistem operasi menyimpan aplikasi 32-bit di direktori x86 terpisah.
Windows 32-bit	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\user_log_config.json

Lingkungan Kontainer
File user_log_config.json disimpan dalam kontainer Logtail. Path file adalah /usr/local/ilogtail/user_log_config.json.

Contoh File

$cat /usr/local/ilogtail/user_log_config.json
{
   "metrics" : {
      "##1.0##k8s-log-c12ba2028*****939f0b$app-java" : {
         "aliuid" : "16542189*****50",
         "category" : "app-java",
         "create_time" : 1534739165,
         "defaultEndpoint" : "cn-hangzhou-intranet.log.aliyuncs.com",
         "delay_alarm_bytes" : 0,
         "enable" : true,
         "enable_tag" : true,
         "filter_keys" : [],
         "filter_regs" : [],
         "group_topic" : "",
         "local_storage" : true,
         "log_type" : "plugin",
         "log_tz" : "",
         "max_send_rate" : -1,
         "merge_type" : "topic",
         "plugin" : {
            "inputs" : [
               {
                  "detail" : {
                     "IncludeEnv" : {
                        "aliyun_logs_app-java" : "stdout"
                     },
                     "IncludeLable" : {
                        "io.kubernetes.container.name" : "java-log-demo-2",
                        "io.kubernetes.pod.namespace" : "default"
                     },
                     "Stderr" : true,
                     "Stdout" : true
                  },
                  "type" : "service_docker_stdout"
               }
            ]
         },
         "priority" : 0,
         "project_name" : "k8s-log-c12ba2028c*****ac1286939f0b",
         "raw_log" : false,
         "region" : "cn-hangzhou",
         "send_rate_expire" : 0,
         "sensitive_keys" : [],
         "tz_adjust" : false,
         "version" : 1
      }
   }
}

File rekaman AppInfo (app_info.json)

File app_info.json mencatat informasi tentang Logtail, seperti waktu startup, alamat IP yang diperoleh, dan hostname.

Jika Anda memetakan alamat IP server ke hostname dalam file /etc/hosts server, Logtail langsung mendapatkan alamat IP. Jika Anda tidak memetakan alamat IP server ke hostname, Logtail mendapatkan alamat IP dari antarmuka kontrol jaringan (NIC) pertama pada server.

Penting

File rekaman AppInfo hanya mencatat informasi dasar tentang Logtail. Jika Anda memodifikasi file ini, alamat IP yang diperoleh oleh Logtail tidak berubah.
Jika Anda memodifikasi pengaturan jaringan server, seperti hostname, Anda harus me-restart Logtail untuk mendapatkan alamat IP baru.

Path File

Lingkungan Host

Sistem operasi	Logtail	Path ke file app_info.json
Linux	Logtail (64-bit)	/usr/local/ilogtail/app_info.json
Windows 64-bit	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\app_info.json
Windows 64-bit	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\app_info.json Catatan Anda dapat menjalankan aplikasi 32-bit dan 64-bit di Windows 64-bit. Untuk memastikan kompatibilitas, sistem operasi menyimpan aplikasi 32-bit di direktori x86 terpisah.
Windows 32-bit	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\app_info.json

Lingkungan Kontainer
File app_info.json disimpan dalam kontainer Logtail. Path file adalah /usr/local/ilogtail/app_info.json.

Contoh File

$cat /usr/local/ilogtail/app_info.json
{
   "UUID" : "",
   "hostname" : "logtail-ds-slpn8",
   "instance_id" : "E5F93BC6-B024-11E8-8831-0A58AC14039E_1**.***.***.***_1536053315",
   "ip" : "1**.***.***.***",
   "logtail_version" : "0.16.13",
   "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
   "update_time" : "2018-09-04 09:28:36"
}

Bidang	Deskripsi
UUID	Nomor seri server.
hostname	Nama host.
instance_id	Pengenal unik Logtail. Pengenal ini dibuat secara acak.
ip	Alamat IP yang diperoleh oleh Logtail. Jika Logtail tidak mendapatkan alamat IP, bidang ini kosong, dan Logtail tidak dapat berjalan sebagaimana mestinya. Dalam hal ini, Anda harus menentukan alamat IP untuk server dan me-restart Logtail. Catatan Jika Anda membuat grup mesin berbasis alamat IP, pastikan alamat IP yang Anda tentukan untuk grup mesin konsisten dengan nilai bidang ini. Jika alamat IP yang Anda tentukan untuk grup mesin tidak konsisten dengan nilai bidang ini, masuk ke konsol Simple Log Service dan ubah alamat IP grup mesin. Tunggu selama 1 menit dan lihat alamat IP grup mesin di konsol Simple Log Service.
logtail_version	Versi Logtail.
os	Versi sistem operasi.
update_time	Waktu startup terbaru Logtail.

File log operasional Logtail (ilogtail.LOG)

File ilogtail.LOG mencatat log operasional Logtail. Tingkat log dalam urutan menaik adalah INFO, WARN, dan ERROR. Anda dapat mengabaikan log pada tingkat INFO.

Jika terjadi kesalahan selama pengumpulan log, lakukan pemecahan masalah berdasarkan jenis kesalahan dan log operasional Logtail. Untuk informasi lebih lanjut, lihat Bagaimana cara melihat kesalahan pengumpulan Logtail?

Catatan

Anda harus mengunggah file ilogtail.LOG saat Anda mengajukan ticket untuk memecahkan masalah kesalahan pengumpulan Logtail.

Path File

Lingkungan Host

Sistem operasi	Logtail	Path ke file ilogtail.LOG
Linux	Logtail (64-bit)	/usr/local/ilogtail/ilogtail.LOG
Windows 64-bit	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG
Windows 64-bit	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail.LOG Catatan Anda dapat menjalankan aplikasi 32-bit dan 64-bit di Windows 64-bit. Untuk memastikan kompatibilitas, sistem operasi menyimpan aplikasi 32-bit di direktori x86 terpisah.
Windows 32-bit	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG

Lingkungan Kontainer
File ilogtail.LOG disimpan dalam kontainer Logtail. Path file adalah /usr/local/ilogtail/ilogtail.LOG.

Contoh File

$tail /usr/local/ilogtail/ilogtail.LOG
[2018-09-13 01:13:59.024679]    [INFO]    [3155]    [build/release64/sls/ilogtail/elogtail.cpp:123]    mengubah direktori kerja:/usr/local/ilogtail/
[2018-09-13 01:13:59.025443]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:175]    memuat file konfigurasi logtail, path:/etc/ilogtail/conf/ap-southeast-1/ilogtail_config.json
[2018-09-13 01:13:59.025460]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:176]    memuat file konfigurasi logtail, detail:{
   "config_server_address" : "http://logtail.ap-southeast-1-intranet.log.aliyuncs.com",
   "data_server_list" : [
      {
         "cluster" : "ap-southeast-1",
         "endpoint" : "ap-southeast-1-intranet.log.aliyuncs.com"
      }
]

File log operasional plugin Logtail (logtail_plugin.LOG)

File logtail_plugin.LOG mencatat log operasional plugin Logtail. Tingkat log dalam urutan menaik adalah INFO, WARN, dan ERROR. Anda dapat mengabaikan log pada tingkat INFO.

Jika pesan kesalahan CANAL_RUNTIME_ALARM muncul saat Anda mendiagnosis kesalahan pengumpulan log, Anda dapat melakukan pemecahan masalah berdasarkan file logtail_plugin.LOG.

Catatan

Anda harus mengunggah file ini saat Anda mengajukan ticket untuk memecahkan masalah kesalahan plugin Logtail.

Path File

Lingkungan Host

Sistem operasi	Logtail	Path ke file logtail_plugin.LOG
Linux	Logtail (64-bit)	/usr/local/ilogtail/logtail_plugin.LOG
Windows 64-bit	Logtail (64-bit)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG
Windows 64-bit	Logtail (32-bit)	C:\Program Files (x86)\Alibaba\Logtail\logtail_plugin.LOG Catatan Anda dapat menjalankan aplikasi 32-bit dan 64-bit di Windows 64-bit. Untuk memastikan kompatibilitas, sistem operasi menyimpan aplikasi 32-bit di direktori x86 terpisah.
Windows 32-bit	Logtail (32-bit)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG

Lingkungan Kontainer
File logtail_plugin.LOG disimpan dalam kontainer Logtail. Path file adalah /usr/local/ilogtail/logtail_plugin.LOG.

Contoh File

$tail /usr/local/ilogtail/logtail_plugin.LOG
2018-09-13 02:55:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
2018-09-13 02:55:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
2018-09-13 03:00:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
2018-09-13 03:00:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    open file for read, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    open file for read, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
2018-09-13 03:04:26 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    close file, reason:no read timeout    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
2018-09-13 03:04:27 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    close file, reason:no read timeout    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
2018-09-13 03:05:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
2018-09-13 03:05:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop

File pemetaan path kontainer (docker_path_config.json)

File docker_path_config.json dibuat hanya saat Anda mengumpulkan log kontainer. File ini mencatat pemetaan path antara file log kontainer dan file log host dalam format JSON.

Jika pesan kesalahan DOCKER_FILE_MAPPING_ALARM muncul saat Anda mendiagnosis kesalahan pengumpulan log, Anda dapat melakukan pemecahan masalah berdasarkan file docker_path_config.json. Pesan kesalahan tersebut menunjukkan bahwa file Docker tidak dapat dipetakan ke file host.

Catatan

File docker_path_config.json adalah file rekaman. Modifikasi pada file ini tidak akan berlaku. Jika Anda menghapus file ini, file lain akan otomatis dibuat tanpa gangguan layanan.
Anda harus mengunggah file ini saat Anda mengajukan ticket untuk memecahkan masalah kesalahan pengumpulan log kontainer.

Path File
/usr/local/ilogtail/docker_path_config.json

Contoh File

$cat /usr/local/ilogtail/docker_path_config.json
{
   "detail" : [
      {
         "config_name" : "##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$nginx",
         "container_id" : "df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10",
         "params" : "{\n   \"ID\" : \"df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10\",\n   \"Path\" : \"/logtail_host/var/lib/docker/overlay2/947db346695a1f65e63e582ecfd10ae1f57019a1b99260b6c83d00fcd1892874/diff/var/log\",\n   \"Tags\" : [\n      \"nginx-type\",\n      \"access-log\",\n      \"_image_name_\",\n      \"registry.cn-hangzhou.aliyuncs.com/log-service/docker-log-test:latest\",\n      \"_container_name_\",\n      \"nginx-log-demo\",\n      \"_pod_name_\",\n      \"nginx-log-demo-h2lzc\",\n      \"_namespace_\",\n      \"default\",\n      \"_pod_uid_\",\n      \"87e56ac3-b65b-11e8-b172-00163f008685\",\n      \"_container_ip_\",\n      \"172.20.4.224\",\n      \"purpose\",\n      \"test\"\n   ]\n}\n"
      }
   ],
   "version" : "0.1.0"
}