All Products
Search
Document Center

Simple Log Service:GetMLServiceResults

Last Updated:Jun 11, 2026

Alibaba Cloud Simple Log Service (SLS) menyediakan analisis cerdas untuk data seperti log, metrik, dan jejak. Anda dapat memanggil model untuk mendapatkan hasil analisis secara langsung. Fitur utamanya meliputi Named Entity Recognition (NER) untuk data log, Deteksi anomali untuk data deret waktu, dan analisis akar penyebab untuk span jejak berlatensi tinggi.

Deskripsi operasi

This API endpoint is available only in the China (Shanghai) and Singapore regions. The following basic permissions are required:

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "log:Get*"
            ],
            "Resource": [
                "acs:log:*:*:mlservice/sls_builtin_*"
            ],
            "Effect": "Allow"
        }
    ]
}

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /ml/service/{serviceName}/analysis HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

serviceName

string

No

Nama layanan.

Valid values:

  • sls_builtin_service_trace_rca :

    Layanan untuk menganalisis permintaan jejak berlatensi tinggi.

  • sls_builtin_service_log_struct :

    Layanan untuk LogNER.

  • sls_builtin_service_metric_anomaly :

    Layanan untuk Deteksi anomali deret waktu dimensi tunggal.

sls_builtin_service_log_struct

Parameter permintaan

Parameter

Type

Required

Description

Example

allowBuiltin

boolean

No

  • true: Permintaan dapat menggunakan layanan sistem bawaan.

  • false: Permintaan tidak dapat menggunakan layanan sistem bawaan.

Valid values:

  • true :

    Permintaan dapat menggunakan layanan sistem bawaan.

  • false :

    Permintaan tidak dapat menggunakan layanan sistem bawaan.

true

version

string

No

Nomor versi algoritma. Versi yang berbeda sesuai dengan algoritma yang berbeda.

v1

body MLServiceAnalysisParam

No

Struct permintaan.

Valid values:

  • others :

    Konten bervariasi berdasarkan nilai serviceName.

Parameter permintaan bervariasi tergantung pada layanan. Detailnya adalah sebagai berikut:

Named Entity Recognition untuk log (sls_builtin_service_log_struct)

Detail body.parameter

{
  "is_struct": "true",
  "use_gpu": "true/false",
  "max_fields": "1"
}
  • Jika is_struct adalah true, log berada dalam format JSON. Saat ini, Anda hanya dapat mengatur parameter ini ke true.

  • use_gpu menentukan apakah akan menggunakan sumber daya GPU.

  • max_fields menentukan jumlah maksimum field yang akan dianalisis saat log berada dalam format JSON. Secara default, satu field dianalisis.

Detail body.input

[
  {
    "{column_name}": "{column_value}"
  }
]

Input adalah array objek JSON, di mana:

  • column_name adalah nama field dalam log berformat JSON.

  • column_value adalah nilai field dalam log berformat JSON.

Deteksi anomali deret waktu (sls_builtin_service_metric_anomaly)

Detail body.parameter

{
  "isOrdered": "true/false",
  "keys": "[]",
  "timeColumnName": "",
  "analysisColumnNames": "[]",
  "interval": "-1"
}
  • isOrdered menentukan apakah data input terurut. Atur parameter ini ke true jika deret waktu input diurutkan secara menaik berdasarkan pengatur waktu. Jika tidak, atur ke false.

  • interval menentukan interval deret waktu dalam detik. Misalnya, jika deret memiliki satu titik data per menit, atur parameter ini ke 60. Jika Anda tidak yakin dengan intervalnya, atur parameter ini ke -1.

  • timeColumnName menentukan nama dimensi pengatur waktu dalam deret input.

  • analysisColumnNames menentukan nama dimensi fitur numerik yang akan dianalisis dalam deret input. Ini adalah array yang harus diserialisasi menjadi string.

  • keys menentukan nama semua kolom dalam data input. Ini adalah array yang harus diserialisasi menjadi string.

Detail body.input

[
  {
    "{column_name}": "{column_value}"
  }
]

Input adalah array, di mana:

  • column_name adalah nama field dalam deret.

  • column_value adalah nilai field. Jika {column_name} sama dengan {timeColumnName}, nilainya adalah timestamp UNIX dalam detik.

Deteksi jejak berlatensi tinggi (sls_builtin_service_trace_rca)

Detail body.parameter

{
  "project": "",
  "logstore": "",
  "endpoint": "",
  "role_arn": ""
}
  • project menentukan nama project di SLS tempat data jejak disimpan.

  • logstore menentukan nama Logstore di SLS tempat data jejak disimpan.

  • endpoint menentukan Titik akhir wilayah tempat project berada. Anda harus menggunakan Titik akhir Internet. Titik akhir internal di wilayah yang sama tidak dapat diakses.

  • role_arn menentukan ARN peran yang diberikan izin ke sumber daya. Anda harus menggunakan ARN dari ETLRole atau AuditRole.

Detail body.input

[
  {
    "service": "",
    "name": "",
    "from_ts_sec": "",
    "to_ts_sec": "",
    "slo_ts_micro": "",
    "batch_id": "",
    "trace_ids": "[]"
  }
]

Input adalah array dengan panjang 1. Parameter dijelaskan sebagai berikut:

  • service menentukan nama layanan untuk satu atau beberapa TraceID yang akan didiagnosis. Anda dapat mengambilnya dari Logstore.

  • name menentukan nama layanan untuk satu atau beberapa TraceID yang akan didiagnosis. Anda dapat mengambilnya dari Logstore.

  • from_ts_sec menentukan timestamp awal untuk analisis, dalam detik.

  • to_ts_sec menentukan timestamp akhir untuk analisis, dalam detik.

  • batch_id menentukan nama untuk batch TraceID saat ini yang akan dianalisis.

  • trace_ids menentukan daftar trace_ids untuk permintaan saat ini. Ini harus berupa string yang diserialisasi JSON.

Elemen respons

Element

Type

Description

Example

object

The returned struct.

Valid values:

  • 无 :

    Tidak ada.

status

object

The status of the task.

Valid values:

  • 无 :

    None

string

By default, this parameter is empty, and tasks in all statuses are returned. Supported statuses are success, fail, and running.

Valid values:

  • 无 :

    None

200

data

array<object>

The returned data.

object

The dataset struct.

string

The returned result.

{'marker': ''}

Nilai pengembalian bervariasi tergantung pada layanan. Detailnya adalah sebagai berikut:

Named Entity Recognition untuk log (sls_builtin_service_log_struct)

Detail data

[
  {
    "{column_name}": "{column_value}"
  }
]

Setiap objek JSON dalam output sesuai dengan objek JSON dalam log input, di mana:

  • column_name adalah nama field yang dianalisis dalam log berformat JSON. Maksimum max_fields field yang dianalisis.

  • column_value adalah nilai field yang dianalisis. Hasil NER dalam nilai field diapit oleh tag <ml_ner_${ner_type}></ml_ner_${ner_type}>, di mana ${ner_type} adalah tipe NER tertentu.

Deteksi anomali deret waktu (sls_builtin_service_metric_anomaly)

Detail data

[
  {
    "start": "",
    "end": "",
    "label": ""
  }
]
  • start menentukan pengatur waktu awal interval anomali yang terdeteksi.

  • end menentukan pengatur waktu akhir interval anomali yang terdeteksi.

  • label menentukan tipe anomali yang terdeteksi dalam interval saat ini.

    • SPIKE_UP_TYPE

    • SPIKE_DOWN_TYPE

    • TREND_UP_TYPE

    • TREND_DOWN_TYPE

    • MEANSHIFT_UPWARD_TYPE

    • MEANSHIFT_DOWNWARD_TYPE.

Deteksi jejak berlatensi tinggi (sls_builtin_service_trace_rca)

Detail data

[
  {
    "traceID": "",
    "service": "",
    "name": "",
    "rootCauses": "[{}]"
  }
]
  • traceID menentukan ID jejak yang dianalisis.

  • service menentukan nama layanan dari node root jejak.

  • name menentukan nama node root jejak.

  • rootCauses menentukan daftar span yang menyebabkan latensi tinggi dalam jejak. Ini adalah string yang diserialisasi. Saat dideserialisasi, struktur field ini adalah sebagai berikut:

[
  {
    "spanID": "",
    "service": "",
    "name": "",
    "host": "xxxx",
    "predicateDuration": 10
  }
]
```.

Contoh

Respons sukses

JSONformat

{
  "status": {
    "key": "200"
  },
  "data": [
    {
      "key": "{'marker': ''}"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.