Konfigurasi Simple Log Service CLI - Simple Log Service

Setelah mengonfigurasi Simple Log Service CLI, Anda tidak perlu lagi menentukan parameter global setiap kali menjalankan perintah. Parameter global meliputi pasangan AccessKey, titik akhir, dan format keluaran. Dokumen ini menjelaskan cara mengonfigurasi akun CLI dan parameter global.

Menggunakan kredensial Alibaba Cloud CLI

Simple Log Service CLI dapat menggunakan kredensial yang dikonfigurasikan untuk Alibaba Cloud CLI guna memverifikasi akun. Jika Anda telah menginstal Alibaba Cloud CLI, konfigurasi akun tidak diperlukan. Untuk informasi lebih lanjut, lihat Konfigurasi Alibaba Cloud CLI.

Simple Log Service CLI membaca kredensial dari sumber berikut dalam urutan prioritas menurun: subperintah Simple Log Service CLI, file konfigurasi Simple Log Service CLI, file konfigurasi Alibaba Cloud CLI, dan variabel lingkungan.

Sumber kredensial (urutan prioritas menurun)	Deskripsi
Parameter global yang diteruskan ke subperintah Simple Log Service CLI, seperti pasangan AccessKey dan wilayah	Ketika subperintah dijalankan, Simple Log Service CLI membaca kredensial dari parameter dalam subperintah untuk verifikasi. Sumber ini memiliki prioritas tertinggi.
Parameter profile yang dikonfigurasikan untuk Simple Log Service CLI	Ketika subperintah dijalankan, Simple Log Service CLI membaca kredensial berdasarkan pengaturan berikut: `--profile=Nama konfigurasi kredensial dalam file config.json Alibaba Cloud CLI`. Untuk informasi lebih lanjut tentang parameter --profile, lihat Parameter global.
Variabel lingkungan ALIYUN_LOG_CLI yang dikonfigurasikan untuk Simple Log Service CLI	Simple Log Service CLI membaca kredensial dari variabel lingkungan ALIYUN_LOG_CLI yang dikonfigurasikan dalam sistem.
File konfigurasi Simple Log Service CLI	File tersebut dinamai dalam format .aliyunlogcli. Untuk informasi lebih lanjut, lihat Konfigurasikan titik akhir dan pasangan AccessKey untuk akun default dan Konfigurasikan titik akhir dan pasangan AccessKey untuk beberapa akun.
Variabel lingkungan ALIBABACLOUD yang dikonfigurasikan untuk Alibaba Cloud CLI	Simple Log Service CLI membaca kredensial dari variabel lingkungan ALIBABACLOUD yang dikonfigurasikan dalam sistem.
Variabel lingkungan ALICLOUD yang dikonfigurasikan untuk Alibaba Cloud CLI	Simple Log Service CLI membaca kredensial dari variabel lingkungan ALICLOUD yang dikonfigurasikan dalam sistem.
File konfigurasi Alibaba Cloud CLI	Simple Log Service CLI membaca kredensial dari file konfigurasi Alibaba Cloud CLI. Catatan Jalur ke file konfigurasi bervariasi tergantung pada sistem operasi yang digunakan. Linux: ~/.aliyun/config.json Windows: C:\Users\NamaPengguna\.aliyun\config.json

Konfigurasikan titik akhir dan pasangan AccessKey untuk akun default

Secara default, Simple Log Service CLI menggunakan akun main untuk semua operasi. Sebelum menggunakan Simple Log Service CLI, Anda harus mengonfigurasi pasangan AccessKey dan titik akhir untuk akun main, serta memberikan izin yang diperlukan kepada akun main untuk mengelola proyek.

Masuk ke server tempat Simple Log Service CLI diinstal.
Konfigurasikan titik akhir dan pasangan AccessKey untuk akun default.
Jalankan perintah berikut:
```
aliyunlog configure "AccessKey ID" "AccessKey Secret" TitikAkhir
```
- Ganti ID AccessKey dengan ID AccessKey dari akun yang memiliki izin pada Simple Log Service. Ganti Rahasia AccessKey dengan rahasia AccessKey dari akun tersebut. Untuk informasi lebih lanjut, lihat Pasangan AccessKey dan Buat pengguna RAM dan otorisasi pengguna RAM untuk mengakses Simple Log Service.
- Ganti TitikAkhir dengan titik akhir dari sebuah proyek. Kami merekomendasikan penggunaan titik akhir publik. Untuk informasi lebih lanjut, lihat Titik Akhir.
Verifikasi hasil konfigurasi.
Buka file konfigurasi .aliyunlogcli. Jika file tersebut berisi informasi serupa dengan contoh berikut, akun default telah dikonfigurasi.
```
[main]
access-id = LTAI******pLMZ
access-key = XjAsP******eRqax
region-endpoint = cn-hangzhou.log.aliyuncs.com
sts-token =
```
Catatan
Jalur ke file konfigurasi .aliyunlogcli bervariasi tergantung pada sistem operasi yang digunakan.
- Linux: ~/.aliyunlogcli
- Windows: C:\Users\NamaPengguna\.aliyunlogcli
Jika akun default gagal dikonfigurasi, Anda dapat memperbaiki kesalahan berdasarkan kode kesalahan yang dikembalikan.

Konfigurasikan titik akhir dan pasangan AccessKey untuk beberapa akun

Jika Anda ingin mengelola data log lintas akun, Anda harus mengonfigurasi pasangan AccessKey dan titik akhir untuk akun-akun tersebut.

Masuk ke server tempat Simple Log Service CLI diinstal.
Konfigurasikan pasangan AccessKey dan titik akhir untuk beberapa akun.
Jalankan perintah berikut:
```
aliyunlog configure "AccessKey ID" "AccessKey Secret" TitikAkhir Nama
```
- Ganti ID AccessKey dengan ID AccessKey dari akun yang memiliki izin pada Simple Log Service. Ganti Rahasia AccessKey dengan rahasia AccessKey dari akun tersebut. Untuk informasi lebih lanjut, lihat Pasangan AccessKey dan Buat pengguna RAM dan otorisasi pengguna RAM untuk mengakses Simple Log Service.
- Ganti TitikAkhir dengan titik akhir dari sebuah proyek. Kami merekomendasikan penggunaan titik akhir publik. Untuk informasi lebih lanjut, lihat Titik Akhir.
- Ganti Nama dengan nama akun yang Anda konfigurasikan.
Verifikasi hasil konfigurasi.
Buka file konfigurasi ~/.aliyunlogcli. Jika file tersebut berisi informasi serupa dengan contoh berikut, akun-akun telah dikonfigurasi.
```
[main]
access-id = LTAI******pLMZ
access-key = XjAsP******eRqax
region-endpoint = cn-hangzhou.log.aliyuncs.com
sts-token =

[test]
access-id = As******sPzvb
access-key = FtagJeR******bQqax
region-endpoint = cn-shanghai.log.aliyuncs.com
sts-token =
```
Catatan
Jalur ke file konfigurasi .aliyunlogcli bervariasi tergantung pada sistem operasi yang digunakan.
- Linux: ~/.aliyunlogcli
- Windows: C:\Users\NamaPengguna\.aliyunlogcli
Jika akun-akun gagal dikonfigurasi, Anda dapat memperbaiki kesalahan berdasarkan kode kesalahan yang dikembalikan.
Jika Anda menggunakan Simple Log Service CLI untuk menjalankan perintah, Anda dapat menggunakan --client-name=testName untuk menentukan akun yang ingin Anda gunakan. Misalnya, jika Anda menjalankan perintah aliyunlog log create_project ..... --client-name=test, akun test akan digunakan untuk membuat proyek.

Tentukan format keluaran

Simple Log Service CLI dapat memformat keluaran dan meloloskan karakter dalam keluaran. Jika Anda ingin memformat keluaran dan meloloskan karakter, Anda dapat menggunakan metode berikut:

Format keluaran JSON
Secara default, keluaran Simple Log Service CLI berada dalam format JSON dan ditampilkan dalam satu baris. Dalam hal ini, keluarannya sulit dibaca. Untuk meningkatkan keterbacaan, Anda dapat menggunakan salah satu metode berikut untuk memformat keluaran JSON:
- Format keluaran perintah tertentu
  Misalnya, Anda dapat menggunakan perintah aliyunlog log get_log .... --format-output=json untuk memformat keluaran JSON dari perintah get_log.
- Format keluaran semua perintah
  Anda dapat menggunakan perintah aliyunlog configure --format-output=json untuk memformat keluaran JSON dari semua perintah.
Loloskan karakter
Secara default, karakter non-Inggris dalam keluaran Simple Log Service CLI adalah karakter lolos. Jika Anda ingin Simple Log Service CLI mengembalikan karakter asli, seperti string Cina, Anda dapat menentukan no_escape untuk --format-output.
Jika Anda menjalankan perintah aliyunlog configure --format-output=no_escape, Simple Log Service CLI tidak akan meloloskan karakter dalam keluaran perintah. Karakter asli akan dikembalikan.

Loloskan karakter khusus

Jika Anda menjalankan perintah dalam Simple Log Service CLI dan pernyataan kueri berisi tanda dolar ($), aksen grave (`), garis miring terbalik (\), atau tanda seru (!), terjadi kesalahan selama eksekusi, atau hasil kueri tidak akurat.

Dalam hal ini, Anda harus menggunakan garis miring terbalik (\) untuk meloloskan karakter khusus atau menggunakan tanda kutip tunggal (') untuk merujuk karakter khusus. Contoh:

Jika Anda ingin meloloskan karakter khusus dalam parameter kueri menggunakan garis miring terbalik (\), jalankan perintah berikut:
aliyunlog log get_log_all --project="my-project" --logstore="my-logstore" --query="event_name:\$_enter" --from_time="2021-06-24 15:00:00+08:00" --to_time="2021-06-24 16:00:00+08:00"
Jika Anda ingin merujuk karakter khusus dalam parameter kueri menggunakan tanda kutip tunggal ('), jalankan perintah berikut:
aliyunlog log get_log_all --project="my-project" --logstore="my-logstore" --query='event_name:$_enter' --from_time="2021-06-24 15:00:00+08:00" --to_time="2021-06-24 16:00:00+08:00"

Untuk informasi lebih lanjut, lihat Kutipan.