Last9

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

Đối với NPM: sử dụng "command": "npx" và thêm "args": ["-y", "@last9/mcp-server@latest"].

Sau khi tải xuống từ GitHub Releases, giải nén và trỏ đến đường dẫn đầy đủ:

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

Đường dẫn NPM dễ hơn trên Windows — không cần quản lý đường dẫn.

Chạy ở chế độ HTTP

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

Máy chủ khởi động tại http://localhost:8080/mcp.

Kiểm thử bằng curl

Trình xử lý HTTP Streamable chạy ở chế độ không trạng thái (stateless), vì vậy mọi yêu cầu đều được phục vụ độc lập. Bắt tay initialize và header Mcp-Session-Id là tùy chọn — các máy khách gửi chúng vẫn hoạt động (header được chấp nhận và bỏ qua), và máy khách cũng có thể bỏ qua để chuyển thẳng đến tools/list / tools/call. Mỗi công cụ là một truy vấn yêu cầu/phản hồi độc lập; máy chủ không gửi thông báo từ máy chủ đến máy khách, vì vậy GET /mcp (luồng SSE) trả về 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
        }
      }
    }'

Xây dựng từ mã nguồn

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 dành cho phát triển cục bộ. Để sử dụng thực tế, điểm cuối HTTP được lưu trữ sẽ dễ dàng hơn.

Đầu vào thời gian

• Thời gian tuyệt đối (start_time_iso/end_time_iso, hoặc time_iso) được ưu tiên hơn lookback_minutes.
• Đối với cửa sổ tương đối: sử dụng lookback_minutes.
• Đối với cửa sổ tuyệt đối: sử dụng RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• YYYY-MM-DD HH:MM:SS kế thừa chỉ được chấp nhận cho mục đích tương thích.

get_exceptions

• limit (số nguyên, tùy chọn): Số ngoại lệ tối đa. Mặc định: 20.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn): Phạm vi thời gian tuyệt đối.
• service_name (chuỗi, tùy chọn): Lọc theo dịch vụ.
• span_name (chuỗi, tùy chọn): Lọc theo tên span.
• env (chuỗi, tùy chọn): Lọc theo môi trường.

get_service_summary

• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Biểu thức chính quy PromQL. Mặc định là .*. Khớp chính xác cần có neo (ví dụ: ^prod$).
• sort_by (chuỗi, tùy chọn): request_count (mặc định), throughput_rpm, http_4xx_count, http_5xx_count, hoặc grpc_error_count.
• limit (số nguyên, tùy chọn): Số hàng xếp hạng tối đa. Bỏ qua hoặc 0 nghĩa là 10; giá trị trên 100 sẽ được giới hạn xuống 100.

get_service_environments

• start_time_iso / end_time_iso (chuỗi, tùy chọn)

Tất cả các công cụ APM khác đều yêu cầu giá trị env. Sử dụng "" nếu giá trị này trả về rỗng.

get_service_performance_details

• service_name (chuỗi, bắt buộc)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Mặc định là prod.

get_service_operations_summary

• service_name (chuỗi, bắt buộc)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Mặc định là prod.

get_service_dependency_graph

• service_name (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Mặc định là prod.

get_apm_service_deviations

• service_name (chuỗi, tùy chọn): Bỏ qua cho phạm vi toàn bộ hệ thống; cung cấp cho một dịch vụ và các tương quan hoạt động của nó.
• lookback_minutes (số nguyên, tùy chọn): Cửa sổ hiện tại. Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn): Cửa sổ hiện tại tường minh.
• baseline_start_time_iso / baseline_end_time_iso (chuỗi, tùy chọn): Đường cơ sở tường minh. Mặc định là cửa sổ có cùng thời lượng liền kề trước đó.
• datasource (chuỗi, tùy chọn): Giới hạn so sánh trong một nguồn dữ liệu.
• env (chuỗi, tùy chọn): Mặc định là prod.
• max_services / max_operations (số nguyên, tùy chọn): Mặc định 10, tối đa 10 mỗi loại.

get_databases

• env (chuỗi, tùy chọn): Lọc theo môi trường. Mặc định: tất cả.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

get_database_slow_queries

• db_system (chuỗi, tùy chọn): ví dụ: postgresql, mysql, mongodb, redis.
• host (chuỗi, tùy chọn): Máy chủ cơ sở dữ liệu (net_peer_name).
• service_name (chuỗi, tùy chọn): Tên dịch vụ gọi.
• env (chuỗi, tùy chọn)
• min_duration_ms (số thực, tùy chọn): Thời lượng truy vấn tối thiểu tính bằng ms.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định: 20.

get_database_queries

• db_system (chuỗi, tùy chọn)
• host (chuỗi, tùy chọn)
• service_name (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định: 20.

get_database_server_metrics

• db_system (chuỗi, bắt buộc): ví dụ: postgresql, mysql, mongodb, redis, aerospike.
• host (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

prometheus_range_query

• query (chuỗi, bắt buộc): Truy vấn PromQL.
• start_time_iso / end_time_iso (chuỗi, tùy chọn): Mặc định là 60 phút gần nhất.
• lookback_minutes (số thực, tùy chọn): Mặc định: 60.

prometheus_instant_query

• query (chuỗi, bắt buộc)
• time_iso (chuỗi, tùy chọn): Mặc định là hiện tại.
• lookback_minutes (số thực, tùy chọn)

prometheus_label_values

• match_query (chuỗi, tùy chọn): Bộ lọc PromQL.
• label (chuỗi, bắt buộc): Tên nhãn.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

prometheus_labels

• match_query (chuỗi, tùy chọn): Bộ lọc PromQL.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

get_logs

• logjson_query (mảng, bắt buộc): Truy vấn đường ống JSON.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 5.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định máy chủ: 5000.
• index (chuỗi, tùy chọn): physical_index:<name> hoặc rehydration_index:<block_name>.

Đối với kiểm kê dịch vụ dựa trên nhật ký, hãy truy vấn physical_index_service_count trước:

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

Sử dụng service_name làm ServiceName, env làm môi trường khi có, và name làm tên chỉ mục vật lý. Nếu name="default", bỏ qua index; đối với chỉ mục vật lý không mặc định do người dùng chọn, hãy truyền index: "physical_index:<name>". Nếu backend từ chối lọc chỉ mục vật lý tường minh, hãy thử lại mà không có index và báo cáo rằng lọc chỉ mục vật lý tường minh không khả dụng cho backend đó.

get_service_logs

• service_name (chuỗi, bắt buộc)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• limit (số nguyên, tùy chọn): Mặc định: 20.
• env (chuỗi, tùy chọn)
• severity_filters (mảng, tùy chọn): ví dụ: ["error", "warn"]. Logic OR.
• body_filters (mảng, tùy chọn): ví dụ: ["timeout", "failed"]. Logic OR.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• index (chuỗi, tùy chọn)

Nhiều loại bộ lọc kết hợp với AND. Mỗi mảng sử dụng OR nội bộ. Sử dụng get_logs cho số liệu tổng hợp rộng trước; chỉ sử dụng get_service_logs sau khi thu hẹp phạm vi đến một dịch vụ/môi trường/chỉ mục và một tập mẫu nhỏ.

get_log_attributes

• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)
• index (chuỗi, tùy chọn)

get_log_attributes_for_pipeline

• pipeline (mảng, bắt buộc): Các giai đoạn lọc trước để giới hạn phạm vi khám phá, ví dụ: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)
• index (chuỗi, tùy chọn)

get_drop_rules

Không có tham số. Liệt kê các quy tắc loại bỏ qua GET /otel_settings/drop?region=....

add_drop_rule

• name (chuỗi, bắt buộc)
• filters (mảng, bắt buộc): Mỗi bộ lọc: key, value, operator (equals/not_equals), conjunction (and).
• Các khóa bộ lọc phải sử dụng attributes["key_name"] hoặc resource.attributes["key_name"] (bắt buộc bởi API Last9).
• Tạo quy tắc qua POST /otel_settings/drop?region=...&cluster_id=....

get_traces

Sử dụng cho các tìm kiếm và tổng hợp rộng. Để tra cứu ID trace chính xác, hãy sử dụng get_service_traces.

• tracejson_query (mảng, bắt buộc)
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• limit (số nguyên, tùy chọn): Mặc định: 5000.

get_service_traces

Chính xác một trong trace_id hoặc service_name là bắt buộc.

• trace_id (chuỗi, tùy chọn): Khoảng thời gian nhìn lại mặc định: 72 giờ.
• service_name (chuỗi, tùy chọn): Khoảng thời gian nhìn lại mặc định: 60 phút.
• lookback_minutes (số nguyên, tùy chọn)
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định: 10.
• env (chuỗi, tùy chọn)

get_trace_attributes

• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)

get_trace_attributes_for_pipeline

• pipeline (mảng, bắt buộc): Các giai đoạn lọc trước để giới hạn phạm vi khám phá, ví dụ: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)

get_trace_attribute_values

• tag_name (chuỗi, bắt buộc): Tên thuộc tính từ get_trace_attributes (ví dụ: resource_department hoặc attributes['http.method']).
• pipeline (mảng, tùy chọn): Các giai đoạn lọc trước để giới hạn phạm vi giá trị; bỏ qua để lấy giá trị toàn cục.
• region (chuỗi, tùy chọn)

get_trace_attribute_deviations

• comparison_mode (chuỗi, bắt buộc): latency, errors, hoặc time.
• service_name (chuỗi, bắt buộc)
• environment (chuỗi, bắt buộc): Giá trị deployment.environment chính xác.
• operation (chuỗi, tùy chọn)
• filters (mảng, tùy chọn): Các điều kiện lọc JSON trace.
• candidate_attributes (mảng, tùy chọn): Tối đa 8; bỏ qua để khám phá có giới hạn.
• latency_threshold_ms (số, tùy chọn): Bắt buộc cho chế độ latency; bị từ chối cho các chế độ khác.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15. Tối đa: 15.
• baseline_start_time_iso / baseline_end_time_iso (chuỗi, tùy chọn): Bắt buộc cho chế độ time; không chồng lấn và có thời lượng bằng với cửa sổ mục tiêu.
• minimum_cohort_size (số nguyên, tùy chọn): Mặc định: 100. Tối thiểu: 20.
• minimum_value_support (số nguyên, tùy chọn): Mặc định: 20. Tối thiểu: 10.
• limit (số nguyên, tùy chọn): Mặc định: 10. Tối đa: 10.

Yêu cầu khả năng backend đi kèm phải được bật.

get_trace_waterfall

• trace_id (chuỗi, bắt buộc)
• environment (chuỗi, tùy chọn)
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 4320 (72 giờ).
• selected_span_id (chuỗi, tùy chọn): Trả về thuộc tính, sự kiện và liên kết cho span đó.
• max_spans (số nguyên, tùy chọn): Mặc định: 500. Tối đa: 1000.

Trả về một phong bì investigation-evidence/v1; waterfall nằm dưới data.

get_change_events

• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• service_name (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn)
• event_name (chuỗi, tùy chọn): Gọi không có tham số này trước để lấy available_event_names.

get_alert_config

• search_term (chuỗi, tùy chọn): Tìm kiếm văn bản tự do trên tên, nhóm, nguồn dữ liệu, thẻ.
• rule_name (chuỗi, tùy chọn)
• severity (chuỗi, tùy chọn)
• rule_type (chuỗi, tùy chọn): static hoặc anomaly.
• alert_group_name / alert_group_type / data_source_name (chuỗi, tùy chọn)
• tags (mảng, tùy chọn): Tất cả phải khớp (logic AND).

get_alerts

• time_iso (chuỗi, tùy chọn): Thời điểm đánh giá theo RFC3339.
• window (số nguyên, tùy chọn): Khoảng thời gian nhìn lại tính bằng giây. Mặc định: 900. Phạm vi: 60–86400.
• lookback_minutes (số nguyên, tùy chọn): Phạm vi: 1–1440.

get_alert_rule_state

• start_time (số nguyên, bắt buộc): Thời điểm bắt đầu của phạm vi theo Unix epoch (bao gồm).
• end_time (số nguyên, bắt buộc): Thời điểm kết thúc của phạm vi theo Unix epoch (bao gồm).
• step (số nguyên, bắt buộc): Độ phân giải tính bằng giây giữa các mẫu. Số lượng mẫu ((end_time - start_time) / step + 1) bị giới hạn ở mức 100.
• alert_group_id (chuỗi, tùy chọn): Lọc theo ID nhóm cảnh báo.
• rule_name (chuỗi, tùy chọn): Bộ lọc biểu thức chính quy trên tên quy tắc.
• alert_group_name (chuỗi, tùy chọn): Bộ lọc biểu thức chính quy trên tên nhóm cảnh báo.
• label_filters (chuỗi, tùy chọn): Bộ lọc nhãn key=value phân tách bằng dấu phẩy.
• state (chuỗi, tùy chọn): Lọc theo trạng thái (ví dụ: firing).

Trả về một bản đồ JSON của rule_id -> [{timestamp, is_firing}]. Một dấu mốc thời gian tại đó một quy tắc vắng mặt trong phản hồi từ nguồn được báo cáo là is_firing=0 — điều này có nghĩa là "không được quan sát thấy đang kích hoạt", không phải là trạng thái bình thường đã được xác nhận.

get_notification_channels

Không có tham số. Trả về tất cả các kênh thông báo đã cấu hình (Slack, PagerDuty, email, webhook, v.v.).

did_you_mean

• query (chuỗi, bắt buộc): Tên cần tìm kiếm — một phần, sai chính tả hoặc viết tắt.
• type (chuỗi, tùy chọn): Giới hạn theo loại thực thể: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Trả về tối đa 3 kết quả khớp gần nhất kèm điểm tương đồng. Sử dụng công cụ này trước bất kỳ lời gọi công cụ nào khi tên thực thể không chắc chắn. Nếu lời gọi trước đó trả về kết quả rỗng, hãy thử công cụ này trước khi thử lại.

list_dashboards

Không có tham số. Trả về tất cả dashboard tùy chỉnh trong tổ chức dưới dạng mảng JSON với id, name, và siêu dữ liệu.

get_dashboard

• id (chuỗi, bắt buộc): UUID của dashboard.
• region (chuỗi, tùy chọn): Vùng cho việc điền truy vấn bảng điều khiển. Mặc định là vùng nguồn dữ liệu đã cấu hình.

create_dashboard

• dashboard (đối tượng, bắt buộc): Định nghĩa dashboard với name và panels[]. Mỗi bảng điều khiển yêu cầu name, version, layout (x, y, w, h), visualization.type, và queries[].
• metadata (đối tượng, tùy chọn): Siêu dữ liệu dashboard — các trường _category và _type (ví dụ: {"_category":"custom","_type":"metrics"}).

update_dashboard

• id (chuỗi, bắt buộc): UUID của dashboard cần cập nhật.
• dashboard (đối tượng, bắt buộc): Nội dung dashboard thay thế hoàn toàn (cùng cấu trúc với create).
• metadata (đối tượng, tùy chọn): Siêu dữ liệu thay thế. Dashboard hệ thống chỉ đọc trả về lỗi 403.

delete_dashboard

• id (chuỗi, bắt buộc): UUID của dashboard cần xóa. Các dashboard hệ thống chỉ đọc không thể bị xóa.

list_dashboard_snapshots

• dashboard_id (chuỗi, bắt buộc): UUID của dashboard cần liệt kê các ảnh chụp nhanh.

Chỉ trả về siêu dữ liệu (id, name, expires_at, v.v.). Sử dụng get_dashboard_snapshot để lấy dữ liệu bảng điều khiển đã đóng băng.

get_dashboard_snapshot

• id (chuỗi, bắt buộc): UUID của ảnh chụp nhanh.

Trả về ảnh chụp nhanh đã đóng băng đầy đủ bao gồm dashboard_definition, panel_data, time_range, và variables.

delete_dashboard_snapshot

• id (chuỗi, bắt buộc): UUID của ảnh chụp nhanh cần xóa.