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
Test
RAM authorization
|
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_log_struct |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| allowBuiltin |
boolean |
No |
Valid values:
|
true |
| version |
string |
No |
Versi algoritma. Versi yang berbeda sesuai dengan algoritma yang berbeda. |
v1 |
| body | MLServiceAnalysisParam |
No |
Struct permintaan. Valid values:
|
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:
|
||
| data |
array<object> |
Data yang dikembalikan. |
|
|
object |
Struct set data. |
||
|
string |
Hasil yang dikembalikan. |
{'marker': ''} |
|
| status |
object |
Status tugas. Valid values:
|
|
|
string |
Kosong secara default, yang menunjukkan bahwa tugas dalam semua status dikembalikan. Nilai valid: success, fail, dan Berjalan. Valid values:
|
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.