All Products
Search
Document Center

Simple Log Service:GetMLServiceResults

Last Updated:Sep 18, 2026

Menyediakan kemampuan analisis cerdas untuk data dasar (Log, data deret waktu, jejak) di platform Simple Log Service. Anda dapat memanggil model terkait untuk langsung mendapatkan hasil analisis. Saat ini, node yang didukung meliputi: Named Entity Recognition (NER) untuk data log, deteksi pencilan untuk data deret waktu, dan identifikasi rentang penyebab utama untuk data jejak latensi tinggi.

Deskripsi operasi

Operasi API ini hanya tersedia di endpoint China (Shanghai) dan Singapura. Izin dasar berikut diperlukan:

{
    "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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

log:GetMLServiceResults

none

*Semua sumber daya.

*

None None

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 :

    Nama layanan untuk analisis jalur permintaan data jejak latensi tinggi.

  • sls_builtin_service_log_struct :

    Nama layanan untuk LogNER.

  • sls_builtin_service_metric_anomaly :

    Nama layanan untuk deteksi pencilan deret waktu dimensi tunggal.

sls_builtin_service_log_struct

Parameter permintaan

Parameter

Type

Required

Description

Example

allowBuiltin

boolean

No

  • true: Permintaan diizinkan menggunakan layanan bawaan.

  • false: Permintaan tidak diizinkan menggunakan layanan bawaan.

Valid values:

  • true :

    Mengizinkan penggunaan layanan bawaan.

  • false :

    Tidak mengizinkan penggunaan layanan bawaan.

true

version

string

No

Versi algoritma. Versi yang berbeda sesuai dengan algoritma yang berbeda.

v1

body MLServiceAnalysisParam

No

Struct permintaan.

Valid values:

  • others :

    Deskripsi bervariasi tergantung pada nilai serviceName.

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

Pengenalan entitas konten log (sls_builtin_service_log_struct)

Konten terkait body.parameter

{
  "is_struct": "true",
  "use_gpu": "true/false",
  "max_fields": "1"
}
  • Ketika is_struct diatur ke true, format log adalah struktur JSON. Saat ini, hanya nilai true yang didukung.

  • use_gpu menentukan apakah akan menggunakan resource GPU.

  • max_fields menentukan jumlah maksimum field yang akan dianalisis ketika format log adalah struktur JSON. Secara default, hanya satu field yang dianalisis.

Konten terkait body.input

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

Input adalah array JSON, di mana:

  • column_name menentukan nama field dalam log berstruktur JSON.

  • column_value menentukan nilai field dalam log berstruktur JSON.

Deteksi pencilan data deret waktu (sls_builtin_service_metric_anomaly)

Konten terkait body.parameter

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

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

  • timeColumnName menentukan nama dimensi pengatur waktu dalam urutan input.

  • analysisColumnNames menentukan nama dimensi fitur numerik yang akan dianalisis dalam urutan input. Gunakan array dan serialkan menjadi string.

  • keys menentukan nama kolom data input. Gunakan array dan serialkan menjadi string.

Konten terkait body.input

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

Input adalah array, di mana:

  • column_name menentukan nama field dalam urutan.

  • column_value menentukan nilai field dalam urutan. Ketika {column_name} sama dengan {timeColumnName}, nilai tersebut mewakili pengatur waktu sebagai stempel waktu UNIX, dalam detik.

Deteksi data jejak latensi tinggi (sls_builtin_service_trace_rca)

Konten terkait body.parameter

{
  "project": "",
  "logstore": "",
  "endpoint": "",
  "role_arn": ""
}
  • project menentukan nama project di Simple Log Service tempat data jejak yang akan dianalisis disimpan.

  • logstore menentukan nama Logstore di Simple Log Service tempat data jejak yang akan dianalisis disimpan.

  • endpoint menentukan endpoint wilayah tempat project berada. Gunakan endpoint publik karena endpoint internal tidak dapat diakses.

  • role_arn menentukan ARN peran yang telah diberi izin untuk mengakses resource. Gunakan ARN ETLRole atau AuditRole.

Konten terkait 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 dari satu atau sekumpulan ID jejak yang akan didiagnosis. Anda dapat memperoleh nilai ini dari Logstore.

  • name menentukan nama operasi dari satu atau sekumpulan ID jejak yang akan didiagnosis. Anda dapat memperoleh nilai ini dari Logstore.

  • from_ts_sec menentukan pengatur waktu UNIX awal periode analisis, dalam detik.

  • to_ts_sec menentukan pengatur waktu UNIX akhir periode analisis, dalam detik.

  • batch_id menentukan nama batch ID jejak saat ini yang akan dianalisis.

  • trace_ids menentukan daftar ID jejak dalam permintaan saat ini. Serialkan daftar menjadi string menggunakan serialisasi JSON.

Elemen respons

Element

Type

Description

Example

object

Struct tanggapan.

Valid values:

  • 无 :

    Tidak ada.

  • None :

    Tidak ada.

data

array<object>

Data yang dikembalikan.

object

Struct set data.

string

Hasil yang dikembalikan.

{'marker': ''}

status

object

Status tugas.

Valid values:

  • 无 :

    Tidak ada.

  • None :

    None

string

Kosong secara default, yang menunjukkan bahwa tugas dalam semua status dikembalikan. Nilai valid: success, fail, dan Berjalan.

Valid values:

  • 无 :

    Tidak ada.

  • None :

    None

200

Elemen tanggapan bervariasi tergantung pada skenario. Detailnya adalah sebagai berikut:

Pengenalan entitas konten log (sls_builtin_service_log_struct)

Konten terkait data

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

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

  • column_name menentukan nama field yang dianalisis dalam log berstruktur JSON. Maksimum max_fields field yang dianalisis.

  • column_value menentukan nilai field yang dianalisis dalam log berstruktur JSON. Hasil NER dalam nilai field dibungkus dengan tag <ml_ner_${ner_type}></ml_ner_${ner_type}>, di mana ${ner_type} adalah tipe NER tertentu.

Deteksi pencilan data deret waktu (sls_builtin_service_metric_anomaly)

Konten terkait data

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

  • end menentukan pengatur waktu akhir interval anomali yang terdeteksi.

  • label menentukan tipe anomali dari interval saat ini. Nilai valid:
    • SPIKE_UP_TYPE

    • SPIKE_DOWN_TYPE

    • TREND_UP_TYPE

    • TREND_DOWN_TYPE

    • MEANSHIFT_UPWARD_TYPE

    • MEANSHIFT_DOWNWARD_TYPE

Deteksi data jejak latensi tinggi (sls_builtin_service_trace_rca)

Konten terkait data

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

  • service menentukan nama layanan dari rentang root jejak.

  • name menentukan nama operasi dari rentang root jejak.

  • rootCauses menentukan daftar rentang yang menyebabkan latensi tinggi dalam jejak, direpresentasikan sebagai string terserialisasi. Struktur terdeserialisasi dari field ini adalah sebagai berikut:

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.