SLS MCP Server - Simple Log Service - Alibaba Cloud Documentation Center

Simple Log Service (SLS) menyediakan server Model Context Protocol (MCP) resmi yang menghubungkan agen AI ke resource SLS Anda. Setelah menambahkan SLS MCP Server ke agen seperti Qoder atau Codex, Anda dapat menjelajahi proyek dan LogStore, melakukan kueri serta analisis log, dan mendiagnosis alert menggunakan bahasa alami.

Apa yang dapat Anda lakukan dengan SLS MCP Server

SLS MCP Server menyediakan 11 tool dalam tiga kategori. Agen AI akan memilih tool yang sesuai dengan permintaan Anda, sehingga Anda tidak perlu mengingat titik masuk konsol atau menulis pernyataan kueri secara manual.

Resource discovery — Tanyakan proyek dan LogStore mana saja yang Anda miliki, alih-alih masuk ke konsol dan menjelajahinya satu per satu.
Log query and analysis — Jelaskan apa yang ingin Anda kueri dalam satu kalimat, tanpa perlu berpindah-pindah halaman konsol. Tool ini mencakup alur umum analisis log: periksa konfigurasi indeks, jalankan kueri, lalu tinjau distribusinya sepanjang waktu.
Alert diagnostics — Setelah alert dipicu, mintalah agen AI untuk menganalisis penyebabnya dan menemukan masalah dengan cepat.
Untuk daftar tool di setiap kategori, lihat bagian Supported tools.

Cara kerja SLS MCP Server

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan asisten AI terhubung ke sumber data eksternal dan tool secara seragam. Ketika suatu layanan menyediakan server MCP, asisten AI dapat menggunakan kemampuannya secara plug and play.

SLS MCP Server dijalankan di mesin lokal Anda. Setelah agen AI terhubung dengannya, server tersebut memanggil SLS OpenAPI atas nama Anda menggunakan kredensial OAuth yang telah Anda konfigurasikan. Diagram berikut menunjukkan alur end-to-end-nya.

AI agent (Qoder, Codex, dan lainnya)
 │ MCP protocol (stdio transport)
 ▼
alibabacloud-sls-mcp-proxy (berjalan secara lokal)
 │ Kredensial OAuth (dari profil Alibaba Cloud CLI)
 ▼
Simple Log Service (SLS) OpenAPI

Pertimbangan

Tinjau hal-hal berikut sebelum menghubungkan SLS MCP Server ke agen AI:

Autentikasi — SLS MCP Server melakukan autentikasi ke SLS dengan kredensial OAuth yang disimpan dalam profil Alibaba Cloud CLI. Anda masuk melalui browser, sehingga tidak perlu membuat atau menempelkan Pasangan Kunci Akses (AccessKey pair).
Otorisasi RAM satu kali — Sebelum siapa pun dalam Akun Alibaba Cloud melakukan login OAuth untuk pertama kalinya, administrator RAM harus menginstal aplikasi official-cli dan menambahkan pengguna atau role RAM yang menggunakan Alibaba Cloud CLI ke daftar otorisasi. Untuk petunjuknya, lihat bagian Grant OAuth access to Alibaba Cloud CLI.
Akses tanpa wilayah — Anda tidak perlu menentukan wilayah proyek saat mengaksesnya. SLS MCP Server akan mencocokkan wilayah yang sesuai secara otomatis, sehingga satu profil kredensial memberi Anda akses lintas wilayah ke semua proyek Anda.
Perilaku tool alert — Tool diagnostik alert bersifat read-only dan tidak mengubah status alert apa pun. Masking berbeda-beda tergantung tool: sls_list_alerts tidak mengembalikan pernyataan kueri maupun target notifikasi, sedangkan sls_get_alert mengembalikan kueri diagnostik dengan konfigurasi notifikasi sensitif yang dimasking.

Prasyarat

Akun Alibaba Cloud. Jika Anda menggunakan pengguna Resource Access Management (RAM), pengguna RAM tersebut harus memiliki izin akses ke SLS.
Tool uv telah diinstal di mesin lokal Anda. SLS MCP Server dijalankan dengan perintah uvx, yang disediakan bersama uv. Untuk petunjuk instalasi, lihat dokumentasi uv.

Grant OAuth access to Alibaba Cloud CLI

Administrator RAM melakukan langkah-langkah berikut satu kali untuk Akun Alibaba Cloud. Anda tidak perlu mengulanginya di kemudian hari. Jika Anda bukan administrator RAM, pastikan administrator Anda telah menyelesaikan otorisasi ini sebelum memulai quick start.

Instal aplikasi CLI: Masuk ke RAM console. Di panel navigasi kiri, pilih OAuth (Preview), lalu klik tab Third-party Application. Jika aplikasi official-cli belum terdaftar, pilih Official CLI untuk menginstalnya.
Tetapkan identitas: Buka halaman detail aplikasi official-cli dan klik tab Allowed Identities. Klik Add Users or roles untuk menambahkan pengguna atau role RAM yang perlu menggunakan Alibaba Cloud CLI ke daftar otorisasi.

Quick start

Langkah-langkah berikut dilakukan oleh pengguna agen AI. Langkah ini mengasumsikan bahwa otorisasi OAuth satu kali yang dijelaskan pada bagian sebelumnya telah selesai.

Langkah 1: Instal Alibaba Cloud CLI

Jalankan perintah berikut untuk menginstal Alibaba Cloud CLI.

sudo /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

Setelah instalasi selesai, jalankan aliyun version. Jika perintah tersebut mengembalikan nomor versi, instalasi berhasil.

Langkah 2: Login dengan OAuth dan buat profil kredensial

Jalankan perintah berikut. Halaman browser akan terbuka secara otomatis. Selesaikan proses login untuk menyelesaikan autentikasi.

aliyun configure --mode OAuth

Setelah login berhasil, Alibaba Cloud CLI menyimpan kredensial OAuth dalam sebuah profil. Nama profil default adalah default. Untuk mengelola beberapa akun atau lingkungan, gunakan parameter -p untuk menentukan nama profil kustom.

aliyun configure --mode OAuth -p sls-test-oauth

Catat nama profil yang Anda gunakan. Anda akan menentukannya dengan parameter --profile pada Langkah 3.

Catatan

Masukkan cn-hangzhou saat CLI meminta Anda memasukkan wilayah. Wilayah yang Anda tentukan tidak membatasi proyek yang dapat diakses oleh SLS MCP Server.

Langkah 3: Tambahkan SLS MCP Server ke AI agent Anda

Lengkapi konfigurasi untuk client yang Anda gunakan. Anda hanya perlu mengonfigurasi satu client saja. SLS MCP Server menggunakan transport stdio standar, sehingga Anda dapat menghubungkannya ke agen AI apa pun yang mendukung MCP: atur perintah startup ke uvx dan argumennya ke alibabacloud-sls-mcp-proxy@latest --profile <nama profil Anda>.

Contoh berikut menggunakan profil default. Jika Anda membuat profil kustom dengan parameter -p pada Langkah 2, ganti default dengan nama profil tersebut.

Catatan

Perintah uvx alibabacloud-sls-mcp-proxy@latest mengunduh dan menjalankan versi terbaru SLS MCP Server secara lokal. Setiap perintah pada langkah ini memerlukan uvx, yang disediakan bersama uv.

Client yang dikonfigurasi dengan perintah CLI

Qoder

# Tambahkan MCP Server
qodercli mcp add \
  --scope user \
  --transport stdio \
  alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# Daftar MCP Server yang telah Anda tambahkan
qodercli mcp list

Codex

# Tambahkan MCP Server
codex mcp add alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# Daftar MCP Server yang telah Anda tambahkan
codex mcp list

Claude Code

# Tambahkan MCP Server. --scope user menerapkan konfigurasi ke semua proyek pengguna saat ini.
claude mcp add --scope user alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# Daftar MCP Server yang telah Anda tambahkan
claude mcp list

OpenClaw

# Tambahkan MCP Server
openclaw mcp add alibabacloud-sls \
  --command uvx \
  --arg alibabacloud-sls-mcp-proxy@latest \
  --arg --profile \
  --arg default

# Daftar MCP Server yang telah Anda tambahkan
openclaw mcp list

Client yang dikonfigurasi dengan file konfigurasi

Cursor, Cline, Cherry Studio, dan client berbasis JSON lainnya

Untuk client yang mengonfigurasi server MCP dalam file JSON, tambahkan konten berikut ke file konfigurasi MCP:

{
  "mcpServers": {
    "alibabacloud-sls": {
      "command": "uvx",
      "args": [
        "alibabacloud-sls-mcp-proxy@latest",
        "--profile",
        "default"
      ]
    }
  }
}

Hermes Agent

Hermes Agent mengelola server MCP dalam file konfigurasi. Edit file ~/.hermes/config.yaml di direktori home Anda, atau buat file tersebut jika belum ada, lalu tambahkan konten berikut:

mcp_servers:
  alibabacloud-sls:
    command: uvx
    args:
      - alibabacloud-sls-mcp-proxy@latest
      - --profile
      - default

Simpan file tersebut dan restart Hermes Agent, atau jalankan /reload-mcp dalam sesi untuk memuat ulang konfigurasi MCP.

Langkah 4: Verifikasi koneksi

Buka agen AI Anda dan masukkan permintaan dalam bahasa alami.

List the SLS projects that I can access

Jika agen AI mengembalikan daftar proyek Anda, artinya SLS MCP Server telah terhubung. Jika daftar proyek tidak dikembalikan, pastikan hal-hal berikut:

Perintah uvx tersedia di mesin lokal Anda.
Otorisasi OAuth satu kali mencakup pengguna atau role RAM Anda.
Nilai --profile dalam konfigurasi client sesuai dengan nama profil yang Anda buat pada Langkah 2.

Contoh penggunaan

Setelah koneksi selesai, ajukan pertanyaan dalam bahasa alami langsung di agen AI Anda. Contoh berikut menunjukkan penggunaan khas.

Contoh 1: Temukan resource

List the SLS projects that I can access in the China (Hangzhou) region

Agen AI memanggil sls_list_projects dan mengembalikan daftar proyek. Anda kemudian dapat mengajukan pertanyaan lanjutan:

Which Logstores does the nginx-prod project contain?

Agen AI memanggil sls_list_logstores dan menampilkan LogStore yang sesuai.

Contoh 2: Kueri log

Query the logs that contain error in the access-log Logstore of the nginx-prod project over the last 1 hour

Agen AI memanggil sls_query_logs dan secara otomatis menggunakan rentang waktu relatif seperti now-1h hingga now. Untuk memahami distribusi volume log, ajukan pertanyaan lanjutan:

Approximately how many logs are there? Show me the distribution over time

Agen AI memanggil sls_get_log_histogram dan mengembalikan jumlah total log yang cocok beserta distribusinya sepanjang waktu.

Contoh 3: Lihat konteks log

Satu baris log sering kali tidak memberikan informasi yang cukup selama troubleshooting. Mintalah agen AI untuk mengambil konteks log:

Show me the 20 log lines before and after this error log

Agen AI menggunakan nilai __pack_id__ dan __pack_meta__ dari hasil kueri sebelumnya, memanggil sls_get_context_logs, dan mengembalikan konteks lengkap sebelum dan sesudah log target.

Contoh 4: Mendiagnosis peringatan

Why was my cpu-high alert triggered over the last 24 hours? Run a diagnosis for me

Agen AI memanggil sls_diagnose_alert, yang merangkum siklus hidup, tingkat keparahan, alasan evaluasi, dan bukti kueri dari instans alert tersebut. Ringkasan ini membantu Anda menemukan penyebabnya dengan cepat.

Debug dengan MCP Inspector

Untuk mendebug tool dan parameter SLS MCP Server selama pengembangan, gunakan MCP Inspector resmi untuk membuka antarmuka debugging berbasis browser. Perintah ini memerlukan Node.js di mesin lokal Anda, karena Node.js menyediakan perintah npx. Ganti sls-test-oauth dengan nama profil kredensial Anda.

npx -y @modelcontextprotocol/inspector@latest -- uvx alibabacloud-sls-mcp-proxy@latest --profile sls-test-oauth

Supported tools

Tool	Kategori	Deskripsi
`sls_list_projects`	Resource discovery	Mengambil proyek SLS yang dapat diakses oleh pemanggil saat ini. Mendukung kondisi filter seperti wilayah, nama, dan kelompok sumber daya.
`sls_list_logstores`	Resource discovery	Mengambil LogStore yang menyimpan data log dalam proyek tertentu. Tool ini mengecualikan metricstore.
`sls_list_metricstores`	Resource discovery	Mengambil metricstore yang menyimpan data metrik dalam proyek tertentu.
`sls_get_logstore_index`	Log query and analysis	Mengambil konfigurasi indeks LogStore.
`sls_query_logs`	Log query and analysis	Menjalankan kueri Log Mentah atau analisis SQL SLS. Mendukung rentang waktu relatif.
`sls_get_log_histogram`	Log query and analysis	Menjalankan kueri jumlah total log yang cocok dan distribusinya sepanjang waktu dalam rentang waktu tertentu.
`sls_get_context_logs`	Log query and analysis	Mengambil konteks sebelum dan sesudah log target. Parameter `pack_id` dan `pack_meta` menggunakan nilai `__pack_id__` dan `__pack_meta__` dari log target.
`sls_list_alerts`	Alert diagnostics	Menampilkan ringkasan keamanan aturan alert secara berhalaman. Pernyataan kueri dan target notifikasi tidak dikembalikan.
`sls_get_alert`	Alert diagnostics	Mengambil jadwal, kondisi pemicu, dan kueri diagnostik dari satu aturan alert. Konfigurasi notifikasi sensitif dimasking.
`sls_list_alert_history`	Alert diagnostics	Menjalankan kueri riwayat pemicuan dan penyelesaian alert, beserta hasil kueri yang disimpan oleh mesin alert pada waktu tersebut.
`sls_diagnose_alert`	Alert diagnostics	Merangkum siklus hidup, tingkat keparahan, alasan evaluasi, dan bukti kueri dari instans alert terbaru. Tidak mengubah status alert.

Parameter tool

Tabel berikut menjelaskan parameter input setiap tool. Saat Anda memanggil tool melalui agen AI, biasanya Anda tidak perlu menangani parameter ini karena agen AI akan mengisinya secara otomatis. Gunakan tabel ini untuk penggunaan lanjutan dan debugging.

sls_list_projects

Parameter	Tipe	Wajib	Deskripsi
`offset`	integer	Tidak	Offset pagination berbasis nol. Nilai default: 0.
`size`	integer	Tidak	Jumlah proyek yang dikembalikan per halaman. Nilai default dan nilai maksimum di SLS keduanya 500.
`region_id`	string	Tidak	Filter berdasarkan ID wilayah SLS, misalnya `cn-hangzhou`.
`project_name`	string	Tidak	Filter berdasarkan nama proyek. Bidang ini merupakan kondisi pencarian dan tidak divalidasi terhadap aturan penamaan resource yang tepat.
`resource_group_id`	string	Tidak	Filter berdasarkan ID kelompok sumber daya.
`search_text`	string	Tidak	Kondisi pencarian teks bebas untuk proyek.

sls_list_logstores

Parameter	Tipe	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS target.
`offset`	integer	Tidak	Offset pagination berbasis nol. Nilai default: 0.
`size`	integer	Tidak	Jumlah LogStore yang dikembalikan per halaman. Nilai default dan nilai maksimum di SLS keduanya 500.

sls_list_metricstores

Parameter	Type	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS target.
`offset`	integer	Tidak	Offset pagination berbasis nol. Nilai default: 0.
`size`	integer	Tidak	Jumlah metricstore yang dikembalikan per halaman. Nilai default dan nilai maksimum di SLS keduanya 500.

sls_get_logstore_index

Parameter	Type	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS target.
`logstore`	string	Ya	Nama LogStore yang konfigurasi indeksnya ingin Anda baca.

sls_query_logs

Parameter	Tipe	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS target.
`logstore`	string	Ya	Nama LogStore yang ingin Anda kueri.
`query`	string	Tidak	Pernyataan kueri atau pernyataan analitik SLS. Nilai default: kosong.
`topic`	string	Tidak	Kondisi filter topik SLS.
`from`	string	Ya	Awal rentang waktu kueri. Titik waktu yang ditentukan termasuk, misalnya `1786342175`. Mendukung detik Unix atau waktu relatif seperti `now-1h`.
`to`	string	Ya	Akhir rentang waktu kueri. Titik waktu yang ditentukan tidak termasuk, misalnya `1786342175`. Mendukung detik Unix atau waktu relatif seperti `now`.
`lines`	integer	Tidak	Jumlah maksimum baris yang dikembalikan untuk kueri non-SQL. Nilai default dan nilai maksimum di SLS keduanya 100.
`offset`	integer	Tidak	Offset hasil berbasis nol untuk kueri non-SQL. Nilai default: 0.
`reverse`	boolean	Tidak	Menentukan apakah hasil kueri non-SQL dikembalikan dalam urutan kronologis terbalik. Nilai default: `false`.
`power_sql`	boolean	Tidak	Menentukan apakah menggunakan sumber daya komputasi SQL khusus. Nilai default: `false`.

sls_get_log_histogram

Parameter	Tipe	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS target.
`logstore`	string	Ya	Nama LogStore yang ingin Anda kueri.
`from`	integer	Ya	Awal rentang waktu kueri, dalam detik Unix. Titik waktu yang ditentukan termasuk.
`to`	integer	Ya	Akhir rentang waktu kueri, dalam detik Unix. Titik waktu yang ditentukan tidak termasuk.
`topic`	string	Tidak	Kondisi filter topik SLS.
`query`	string	Tidak	Ekspresi kueri SLS. Analisis SQL tidak didukung.

sls_get_context_logs

Parameter	Tipe	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS target.
`logstore`	string	Ya	Nama LogStore yang berisi log target.
`pack_id`	string	Ya	Nilai `__pack_id__` dari hasil `sls_query_logs` sebelumnya.
`pack_meta`	string	Ya	Nilai `__pack_meta__` dari hasil `sls_query_logs` sebelumnya.
`back_lines`	integer	Tidak	Jumlah baris log yang dikembalikan sebelum log target. Nilai default: 10. Nilai maksimum: 100.
`forward_lines`	integer	Tidak	Jumlah baris log yang dikembalikan setelah log target. Nilai default: 10. Nilai maksimum: 100.

sls_list_alerts

Parameter	Tipe	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS yang berisi aturan alert target.
`alert_name`	string	Tidak	Kondisi filter nama aturan alert.
`dashboard`	string	Tidak	Kondisi filter penyedia resource dashboard.
`offset`	integer	Tidak	Offset pagination berbasis nol. Nilai default: 0.
`size`	integer	Tidak	Jumlah aturan alert yang dikembalikan per halaman. Jika nilainya 0 atau parameter dihilangkan, nilai default API SLS yang digunakan.

sls_get_alert

Parameter	Tipe	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS yang berisi aturan alert target.
`alert_name`	string	Ya	Nama persis aturan alert yang ingin Anda ambil.

sls_list_alert_history

Parameter	Tipe	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS yang berisi LogStore `internal-alert-history`.
`alert_name`	string	Tidak	Filter berdasarkan nama persis aturan alert.
`alert_id`	string	Tidak	Filter berdasarkan ID persis instans alert.
`alert_status`	string	Tidak	Filter berdasarkan status siklus hidup alert, misalnya `firing` atau `resolved`.
`from`	string	Ya	Awal rentang waktu kueri riwayat. Titik waktu yang ditentukan termasuk. Mendukung detik Unix atau waktu relatif seperti `now-24h`.
`to`	string	Ya	Akhir rentang waktu kueri riwayat. Titik waktu yang ditentukan tidak termasuk. Mendukung detik Unix atau waktu relatif seperti `now`.
`lines`	integer	Tidak	Jumlah maksimum event riwayat. Nilai default: 20. Nilai maksimum: 100.
`offset`	integer	Tidak	Offset hasil riwayat berbasis nol. Nilai default: 0.

sls_diagnose_alert

Parameter	Type	Wajib	Deskripsi
`project`	string	Ya	Nama proyek SLS yang berisi aturan alert dan LogStore `internal-alert-history`.
`alert_name`	string	Ya	Nama persis aturan alert yang ingin Anda diagnosa.
`alert_id`	string	Tidak	ID instans alert. Jika Anda menghilangkan parameter ini, instans terbaru yang cocok dalam rentang waktu diagnosis akan didiagnosis.
`from`	string	Ya	Awal rentang waktu diagnosis. Titik waktu yang ditentukan termasuk. Mendukung detik Unix atau waktu relatif seperti `now-24h`.
`to`	string	Ya	Akhir rentang waktu diagnosis. Titik waktu yang ditentukan tidak termasuk. Mendukung detik Unix atau waktu relatif seperti `now`.
`max_events`	integer	Tidak	Jumlah event riwayat terbaru yang dikembalikan sebagai bukti diagnosis. Nilai default: 20. Nilai maksimum: 100.

FAQ

Apakah saya perlu mengonfigurasi Pasangan Kunci Akses (AccessKey pair) untuk menggunakan SLS MCP Server?

Tidak. SLS MCP Server mendukung login OAuth: Anda login melalui browser untuk menyelesaikan autentikasi, dan kredensial disimpan dalam profil Alibaba Cloud CLI. Anda tidak perlu membuat atau menempelkan Pasangan Kunci Akses.

Apakah otorisasi administrator RAM perlu diulang?

Tidak. Ini adalah pengaturan satu kali. Setelah administrator RAM menginstal aplikasi official-cli dan menetapkan pengguna atau role RAM, pengguna tersebut dapat langsung login dengan OAuth tanpa mengulangi langkah-langkah tersebut.

Bagaimana cara mengelola beberapa akun atau beberapa lingkungan?

Gunakan parameter -p untuk membuat beberapa profil, misalnya aliyun configure --mode OAuth -p sls-test-oauth. Lalu tentukan nama profil yang sesuai dengan parameter --profile saat Anda menambahkan SLS MCP Server ke client Anda. Anda juga dapat menambahkan server MCP terpisah untuk setiap profil.

Wilayah mana yang harus saya masukkan saat mengonfigurasi kredensial?

Masukkan cn-hangzhou saat CLI meminta Anda memasukkan wilayah, seperti yang dijelaskan pada Langkah 2. Nilai ini tidak membatasi proyek yang dapat Anda akses, karena SLS MCP Server akan mencocokkan wilayah yang sesuai secara otomatis saat Anda mengakses proyek. Untuk melihat resource hanya di satu wilayah, filter berdasarkan parameter region_id saat menampilkan daftar proyek.

Apa yang harus saya lakukan jika perintah `uvx` tidak ditemukan?

Perintah uvx disediakan oleh tool uv, yang merupakan prasyarat untuk SLS MCP Server. Instal uv terlebih dahulu. Untuk petunjuk instalasi, lihat dokumentasi uv. Setelah instalasi selesai, buka terminal baru dan coba lagi.