Last9

{
  "mcp": {
    "servers": {
      "last9": {
        "type": "stdio",
        "command": "/opt/homebrew/bin/last9-mcp",
        "env": {
          "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
        }
      }
    }
  }
}

Untuk NPM: gunakan "command": "npx" dan tambahkan "args": ["-y", "@last9/mcp-server@latest"].

Setelah mengunduh dari GitHub Releases, ekstrak dan arahkan ke path lengkap:

{
  "mcpServers": {
    "last9": {
      "command": "C:\\Users\\<user>\\AppData\\Local\\Programs\\last9-mcp-server.exe",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

Rute NPM lebih mudah di Windows — tidak perlu mengelola path.

Menjalankan dalam Mode HTTP

export LAST9_REFRESH_TOKEN="your_refresh_token"
export LAST9_HTTP=true
export LAST9_PORT=8080
./last9-mcp-server

Server dimulai di http://localhost:8080/mcp.

Menguji dengan curl

Handler Streamable HTTP berjalan dalam mode tanpa status, sehingga permintaan apa pun dilayani secara independen. Jabat tangan initialize dan header Mcp-Session-Id bersifat opsional — klien yang mengirimnya tetap berfungsi (header diterima dan diabaikan), dan klien juga dapat langsung melompat ke tools/list / tools/call. Setiap alat adalah kueri permintaan/respons independen; server tidak mengeluarkan notifikasi server→klien, sehingga GET /mcp (aliran SSE) mengembalikan 405.

# List tools — a session handshake is optional in stateless mode
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Call a tool
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "tools/call",
      "params": {
        "name": "get_service_logs",
        "arguments": {
          "service_name": "your-service-name",
          "lookback_minutes": 30,
          "limit": 10
        }
      }
    }'

Membangun dari Sumber

git clone https://github.com/last9/last9-mcp-server.git
cd last9-mcp-server
go build -o last9-mcp-server
LAST9_HTTP=true ./last9-mcp-server

LAST9_HTTP=true untuk pengembangan lokal. Untuk penggunaan aktual, endpoint HTTP yang dihosting lebih mudah.

Input Waktu

• Waktu absolut (start_time_iso/end_time_iso, atau time_iso) lebih diutamakan daripada lookback_minutes.
• Untuk jendela relatif: gunakan lookback_minutes.
• Untuk jendela absolut: gunakan RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• YYYY-MM-DD HH:MM:SS lama diterima hanya untuk kompatibilitas.

get_exceptions

• limit (integer, opsional): Jumlah maksimum pengecualian. Default: 20.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional): Rentang waktu absolut.
• service_name (string, opsional): Filter berdasarkan layanan.
• span_name (string, opsional): Filter berdasarkan nama span.
• env (string, opsional): Filter berdasarkan lingkungan.

get_service_summary

• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Regex PromQL. Default ke .*. Pencocokan tepat memerlukan jangkar (mis. ^prod$).
• sort_by (string, opsional): request_count (default), throughput_rpm, http_4xx_count, http_5xx_count, atau grpc_error_count.
• limit (integer, opsional): Jumlah maksimum baris yang diperingkat. Diabaikan atau 0 berarti 10; nilai di atas 100 dibatasi ke 100.

get_service_environments

• start_time_iso / end_time_iso (string, opsional)

Semua alat APM lainnya memerlukan nilai env. Gunakan "" jika ini mengembalikan kosong.

get_service_performance_details

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default ke prod.

get_service_operations_summary

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default ke prod.

get_service_dependency_graph

• service_name (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default ke prod.

get_apm_service_deviations

• service_name (string, opsional): Diabaikan untuk cakupan armada; berikan untuk satu layanan dan korelasi operasinya.
• lookback_minutes (integer, opsional): Jendela saat ini. Default: 60.
• start_time_iso / end_time_iso (string, opsional): Jendela saat ini yang eksplisit.
• baseline_start_time_iso / baseline_end_time_iso (string, opsional): Baseline eksplisit. Default ke jendela dengan durasi sama yang tepat sebelumnya.
• datasource (string, opsional): Batasi perbandingan ke satu sumber data.
• env (string, opsional): Default ke prod.
• max_services / max_operations (integer, opsional): Default 10, maks 10 masing-masing.

get_databases

• env (string, opsional): Filter berdasarkan lingkungan. Menerima ekspresi reguler. Default: semua.
• lookback_minutes (integer, opsional): Default: 60. Jendela tidak boleh melebihi 7 hari.
• start_time_iso / end_time_iso (string, opsional)

get_database_slow_queries

• db_system (string, opsional): mis. postgresql, mysql, mongodb, redis.
• host (string, opsional): Host database (net_peer_name).
• service_name (string, opsional): Nama layanan pemanggil.
• env (string, opsional)
• min_duration_ms (float, opsional): Durasi kueri minimum dalam ms.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 20.

get_database_queries

• db_system (string, opsional)
• host (string, opsional)
• service_name (string, opsional)
• env (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 20.

get_database_server_metrics

• db_system (string, wajib): mis. postgresql, mysql, mongodb, redis, aerospike.
• host (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)

prometheus_range_query

• query (string, wajib): Kueri PromQL.
• start_time_iso / end_time_iso (string, opsional): Default ke 60 menit terakhir.
• lookback_minutes (float, opsional): Default: 60.

prometheus_instant_query

• query (string, wajib)
• time_iso (string, opsional): Default ke sekarang.
• lookback_minutes (float, opsional)

prometheus_label_values

• match_query (string, opsional): Filter PromQL.
• label (string, wajib): Nama label.
• start_time_iso / end_time_iso (string, opsional)

prometheus_labels

• match_query (string, opsional): Filter PromQL.
• start_time_iso / end_time_iso (string, opsional)

get_logs

• logjson_query (array, wajib): Kueri pipeline JSON.
• lookback_minutes (integer, opsional): Default: 5.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default server: 5000.
• index (string, opsional): physical_index:<name> atau rehydration_index:<block_name>.

Untuk inventaris layanan berbasis log, kueri physical_index_service_count terlebih dahulu:

sum by (name, service_name, env) (physical_index_service_count{destination="logs"})

Gunakan service_name sebagai ServiceName, env sebagai lingkungan saat ada, dan name sebagai nama indeks fisik. Jika name="default", abaikan index; untuk indeks fisik non-default yang dipilih pengguna, teruskan index: "physical_index:<name>". Jika backend menolak pemfilteran indeks fisik eksplisit, coba lagi tanpa index dan laporkan bahwa pemfilteran indeks fisik eksplisit tidak tersedia untuk backend tersebut.

get_service_logs

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• limit (integer, opsional): Default: 20.
• env (string, opsional)
• severity_filters (array, opsional): mis. ["error", "warn"]. Logika OR.
• body_filters (array, opsional): mis. ["timeout", "failed"]. Logika OR.
• start_time_iso / end_time_iso (string, opsional)
• index (string, opsional)

Beberapa jenis filter digabungkan dengan AND. Setiap array menggunakan OR secara internal. Gunakan get_logs untuk hitungan agregat luas terlebih dahulu; gunakan get_service_logs hanya setelah mempersempit ke layanan/env/index dan kumpulan sampel kecil.

get_log_attributes

• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)
• index (string, opsional)

get_log_attributes_for_pipeline

• pipeline (array, wajib): Tahap filter sebelumnya untuk mempersempit penemuan, mis. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)
• index (string, opsional)

get_drop_rules

Tidak ada parameter. Mencantumkan aturan drop melalui GET /otel_settings/drop?region=....

add_drop_rule

• name (string, wajib)
• filters (array, wajib): Setiap filter: key, value, operator (equals/not_equals), conjunction (and).
• Kunci filter harus menggunakan attributes["key_name"] atau resource.attributes["key_name"] (diwajibkan oleh API Last9).
• Membuat aturan melalui POST /otel_settings/drop?region=...&cluster_id=....

get_traces

Gunakan untuk pencarian luas dan agregasi. Untuk pencarian ID trace yang tepat, gunakan get_service_traces.

• tracejson_query (array, wajib)
• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• limit (integer, opsional): Default: 5000.

get_service_traces

Tepat satu dari trace_id atau service_name wajib diisi.

• trace_id (string, opsional): Lookback default: 72 jam.
• service_name (string, opsional): Lookback default: 60 menit.
• lookback_minutes (integer, opsional)
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 10.
• env (string, opsional)

get_trace_attributes

• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)

get_trace_attributes_for_pipeline

• pipeline (array, wajib): Tahap filter sebelumnya untuk membatasi cakupan penemuan, misalnya [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)

get_trace_attribute_values

• tag_name (string, wajib): Nama atribut dari get_trace_attributes (misalnya resource_department atau attributes['http.method']).
• pipeline (array, opsional): Tahap filter sebelumnya untuk membatasi cakupan nilai; abaikan untuk nilai global.
• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional): Batas historis RFC3339; lebih diutamakan daripada lookback_minutes.
• region (string, opsional)

get_trace_attribute_deviations

• comparison_mode (string, wajib): latency, errors, atau time.
• service_name (string, wajib)
• environment (string, wajib): Nilai deployment.environment yang tepat.
• operation (string, opsional)
• filters (array, opsional): Kondisi filter JSON trace.
• candidate_attributes (array, opsional): Maksimal 8; abaikan untuk penemuan terbatas.
• latency_threshold_ms (number, opsional): Wajib untuk mode latency; ditolak untuk mode lainnya.
• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 15. Maksimum: 15.
• baseline_start_time_iso / baseline_end_time_iso (string, opsional): Wajib untuk mode time; tidak tumpang tindih dan durasinya sama dengan jendela target.
• minimum_cohort_size (integer, opsional): Default: 100. Minimum: 20.
• minimum_value_support (integer, opsional): Default: 20. Minimum: 10.
• limit (integer, opsional): Default: 10. Maksimum: 10.

Memerlukan kapabilitas backend pendamping yang diaktifkan.

get_trace_waterfall

• trace_id (string, wajib)
• environment (string, opsional)
• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 4320 (72 jam).
• selected_span_id (string, opsional): Mengembalikan atribut, peristiwa, dan tautan untuk span tersebut saja.
• max_spans (integer, opsional): Default: 500. Maksimum: 1000.

Mengembalikan envelope investigation-evidence/v1; waterfall berada di bawah data.

get_change_events

• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• service_name (string, opsional)
• env (string, opsional)
• event_name (string, opsional): Panggil tanpa ini terlebih dahulu untuk mendapatkan available_event_names.

get_alert_groups

Inventaris grup alert Compass yang dikonfigurasi untuk audit changeboard / cakupan label. Termasuk grup dengan nol aturan dan grup yang tidak aktif. Tidak mengembalikan PromQL.

• alert_group_name / alert_group_type / data_source_name (string, opsional): Pencocokan substring tidak peka huruf besar/kecil.
• team / tier (string, opsional): Pencocokan tepat tidak peka huruf besar/kecil pada metadata yang dikonfigurasi.
• label_key + label_value (string, opsional): Harus diatur bersamaan. Pencocokan tepat tidak peka huruf besar/kecil pada satu pasangan metadata.labels — baik kunci maupun nilai.

Mengembalikan JSON ringkas {"count":N,"groups":[...]} dengan id, name, type, entity_class, team, tier, metadata.labels, dan jumlah aturan. team / labels kosong berarti tidak diatur.

get_alert_config

• search_term (string, opsional): Pencarian teks bebas di seluruh nama, grup, sumber data, tag.
• rule_name (string, opsional)
• severity (string, opsional)
• rule_type (string, opsional): static atau anomaly.
• alert_group_name / alert_group_type / data_source_name (string, opsional)
• tags (array, opsional): Semua harus cocok (logika AND).

get_alerts

• time_iso (string, opsional): Waktu evaluasi dalam RFC3339.
• window (integer, opsional): Lookback dalam detik. Default: 900. Rentang: 60–86400.
• lookback_minutes (integer, opsional): Rentang: 1–1440.

get_alert_rule_state

• start_time (integer, wajib): Awal rentang dalam epoch Unix (inklusif).
• end_time (integer, wajib): Akhir rentang dalam epoch Unix (inklusif).
• step (integer, wajib): Resolusi dalam detik antar sampel. Jumlah sampel ((end_time - start_time) / step + 1) dibatasi maksimal 100.
• alert_group_id (string, opsional): Filter berdasarkan ID grup alert.
• rule_name (string, opsional): Filter regex pada nama aturan.
• alert_group_name (string, opsional): Filter regex pada nama grup alert.
• label_filters (string, opsional): Filter label key=value yang dipisahkan koma.
• state (string, opsional): Filter berdasarkan status (misalnya firing).

Mengembalikan peta JSON dari rule_id -> [{timestamp, is_firing}]. Stempel waktu saat aturan tidak ada dalam respons upstream dilaporkan sebagai is_firing=0 — ini berarti "tidak teramati aktif", bukan status normal yang terkonfirmasi.

get_notification_channels

Tanpa parameter. Mengembalikan semua saluran notifikasi yang dikonfigurasi (Slack, PagerDuty, email, webhook, dll.).

did_you_mean

• query (string, wajib): Nama yang dicari — sebagian, salah eja, atau disingkat.
• type (string, opsional): Batasi ke jenis entitas: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Mengembalikan hingga 3 kecocokan terdekat dengan skor kemiripan. Gunakan ini sebelum panggilan alat apa pun saat nama entitas tidak pasti. Jika panggilan sebelumnya mengembalikan hasil kosong, coba ini sebelum mencoba ulang.

get_service_profile

• service_name (string, wajib): Layanan untuk membuat profil telemetri.
• datasource (string, opsional): Nama sumber data. Abaikan untuk default.

Mengembalikan ringkasan investigasi singkat diikuti profil lengkap sebagai JSON mentah: keberadaan sinyal (logs/traces/metrics sebagai present, absent, atau unknown), bahasa dan runtime, lingkungan deployment, signal_shape log (log_format, severity_set, level_field), dan perbaikan ingest yang direkomendasikan jika ada. Diturunkan dari upstream dan di-cache dengan TTL sekitar 15 menit.

Panggil sebelum investigasi apa pun yang berfokus pada layanan agar pemilihan alat sesuai dengan telemetri aktual layanan — lewati alat trace saat traces adalah absent, dan saat severity_set adalah none atau partial parse tingkat keparahan dari level_field di badan log daripada menggunakan severity_filters. metrics selalu unknown dan dependencies tidak terisi di v1. Saat logs dan traces keduanya absent, konfirmasi nama dengan did_you_mean sebelum menyimpulkan layanan tidak dipantau.

list_dashboards

Tanpa parameter. Mengembalikan semua dashboard kustom di organisasi sebagai array JSON dengan id, name, dan metadata.

get_dashboard

• id (string, wajib): UUID dashboard.
• region (string, opsional): Wilayah untuk pengisian kueri panel. Default ke wilayah sumber data yang dikonfigurasi.

validate_dashboard

Hanya baca. Tidak pernah membuat atau memperbarui dashboard. Menerima tepat satu dari dashboard_id atau dashboard_definition.

• dashboard_id (string, opsional): UUID dashboard tersimpan untuk divalidasi.
• dashboard_definition (object, opsional): Badan dashboard inline yang belum disimpan (uji coba sungguhan).
• start_time_iso / end_time_iso (string, opsional): Jendela validasi (RFC3339). Harus ≤ 24 jam.
• region (string, opsional): Wilayah untuk eksekusi kueri panel.

Mengembalikan dashboard_validation/v1: klasifikasi lint + eksekusi per panel (data / no_data / invalid / error). Hasil kosong hari pertama diklasifikasikan sebagai valid_no_data tanpa probe diagnostik.

create_dashboard

Hanya baru. Setelah panggilan ini mengembalikan dashboard.id, sempurnakan dengan update_dashboard — jangan buat lagi untuk menambah, memangkas, atau memperbaiki panel.

• dashboard (object, wajib): Definisi dashboard dengan name dan panels[]. Setiap panel memerlukan name, version, layout (x, y, w, h), visualization.type, dan queries[].
• metadata (object, opsional): Metadata dashboard — bidang _category dan _type (misalnya {"_category":"custom","_type":"metrics"}).

update_dashboard

Utamakan ini setelah create. Penggantian penuh berdasarkan id (badan yang sama dengan create).

• id (string, wajib): UUID dashboard untuk diperbarui.
• dashboard (object, wajib): Badan dashboard pengganti penuh (bentuk yang sama dengan create).
• metadata (object, opsional): Metadata pengganti. Dashboard sistem hanya baca mengembalikan kesalahan 403.

delete_dashboard

• id (string, wajib): UUID dashboard untuk dihapus. Dashboard sistem hanya baca tidak dapat dihapus.

list_dashboard_snapshots

• dashboard_id (string, wajib): UUID dashboard yang snapshot-nya akan didaftar.

Mengembalikan metadata saja (id, name, expires_at, dll.). Gunakan get_dashboard_snapshot untuk data panel yang dibekukan.

get_dashboard_snapshot

• id (string, wajib): UUID snapshot.

Mengembalikan snapshot beku lengkap termasuk dashboard_definition, panel_data, time_range, dan variables.

delete_dashboard_snapshot

• id (string, wajib): UUID snapshot untuk dihapus.

get_profile_services

• lookback_minutes / start_time_iso / end_time_iso (opsional): Jendela; lebih suka lookback atau batas ISO eksplisit (default 60 menit).
• region (string, opsional): Penimpaan wilayah.

Mengembalikan layanan yang memiliki data profiling di jendela tersebut. Panggil ini sebelum get_flamegraph / get_top_functions / get_profile_summary.

get_flamegraph

• service (string, wajib): Nama layanan dari get_profile_services.
• profile_type (string, opsional): cpu (default), alloc, atau wall. Sematkan jenis saat membandingkan jendela.
• env / cluster / namespace / runtime (string, opsional): Filter cakupan.
• limit (number, opsional): Baris tumpukan agregat maksimum (default 1000, maks 10000).
• lookback_minutes / start_time_iso / end_time_iso / region (opsional).

Mengembalikan pohon flamegraph bersarang (name / value / self / children). truncated: true berarti batas baris API tercapai.

get_top_functions

Filter yang sama dengan get_flamegraph. Mengembalikan peringkat sampel mandiri dari fungsi terpanas. Mungkin terpotong; periksa truncated.

get_profile_summary

Filter yang sama dengan get_flamegraph. Mengembalikan triase bahasa alami singkat dari profil untuk layanan tersebut.

grafana_search_dashboards

• query (string, opsional): Substring judul. Kosong mencantumkan secara luas (tergantung batas 5.000 baris).

Mengembalikan {"dashboards":[…], "truncated":bool} dengan uid, title, uri, url, type, tags. Gunakan uid dengan grafana_get_dashboard.

grafana_get_dashboard

• uid (string, wajib): uid dashboard Grafana.
• full_json (boolean, opsional): Saat true, kembalikan JSON Grafana mentah alih-alih ringkasan yang difilter. Ringkasan default: versi, tag, variabel templating, dan tipe/ datasource/ gridPos/ target promQL dari setiap panel. Tipe panel plugin yang tidak dikenal muncul di unsupportedPanelTypes.

grafana_list_folders

Tanpa parameter. Mengembalikan pohon folder.

grafana_list_folder_dashboards

• folder_uid (string, wajib): uid folder Grafana.

Mengembalikan {"dashboards":[…], "truncated":bool} untuk dasbor di folder tersebut (dipaginasi hingga 5.000).

grafana_list_datasources

Tanpa parameter. Mengembalikan proyeksi aman dari datasource (tanpa kolom kredensial).