Langsung ke konten utama
POST
/
faults
Membuat gangguan
curl --request POST \
  --url https://api.altostrat.io/faults \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "resource_id": "dev_2j4k2l2j3k4l2j3k4",
  "microservice_id": "manual-api-entry",
  "type": "wan-degradation",
  "severity": "HIGH",
  "message": "Latensi tautan WAN tinggi: Latensi tautan utama (WAN1) meningkat",
  "cause": "Probe latensi melebihi 250ms untuk 5 pemeriksaan berturut-turut.",
  "resource_ancestry_path": "site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"
}'
{
  "id": "flt_31pkd1t8FvW7qZv0jG2a9kH5mB1",
  "resource_id": "dev_2j4k2l2j3k4l2j3k4",
  "customer_id": "cus_1i2j3k4l5m6n7o8p",
  "microservice_id": "wantunnel-monitor",
  "type": "wantunnel",
  "status": "unresolved",
  "severity": "CRITICAL",
  "message": "Failover tautan WAN: Tautan utama (WAN1) mati",
  "cause": "Probe gagal: Latensi melebihi ambang batas 500ms",
  "created_at": "2025-10-21T12:00:00.000000Z",
  "resolved_at": null,
  "resource_ancestry_path": "site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4",
  "ttl": 1797825595,
  "comments": [
    {
      "user_id": "user_a1b2c3d4e5f6g7h8",
      "comment": "Sudah menghubungi ISP, mereka sedang menyelidiki pemadaman lokal.",
      "created_at": "2025-10-21T12:05:30.000000Z"
    }
  ]
}

Authorizations

โ€‹
Authorization
string
header
required

Permintaan API diautentikasi menggunakan JSON Web Token (JWT) yang disediakan di header Authorization.

Body

application/json

Detail gangguan yang akan dibuat.

โ€‹
resource_id
string
required

Pengidentifikasi unik dari sumber daya yang mengalami gangguan.

Example:

"dev_2j4k2l2j3k4l2j3k4"

โ€‹
microservice_id
string
required

Pengidentifikasi microservice yang melaporkan gangguan.

Example:

"manual-api-entry"

โ€‹
type
string
required

Kategori bergaya slug untuk gangguan.

Example:

"wan-degradation"

โ€‹
severity
enum<string>
required

Tingkat keparahan gangguan.

Opsi yang tersedia:
LOW,
MEDIUM,
HIGH,
CRITICAL,
WARNING
Example:

"HIGH"

โ€‹
message
string
required

Ringkasan singkat yang dapat dibaca manusia tentang gangguan.

Example:

"Latensi tautan WAN tinggi: Latensi tautan utama (WAN1) meningkat"

โ€‹
cause
string
required

Penjelasan rinci tentang kemungkinan penyebab.

Example:

"Probe latensi melebihi 250ms untuk 5 pemeriksaan berturut-turut."

โ€‹
resource_ancestry_path
string

Opsional. String yang dipisahkan oleh | (pipe) untuk konteks hierarkis.

Example:

"site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"

Response

Objek gangguan yang baru dibuat.

Objek Fault mewakili masalah atau peristiwa yang terdeteksi di dalam jaringan.

โ€‹
id
string

Pengidentifikasi unik untuk objek gangguan, diawali dengan flt_.

Example:

"flt_31pkd1t8FvW7qZv0jG2a9kH5mB1"

โ€‹
resource_id
string

Pengidentifikasi unik dari sumber daya yang mengalami gangguan.

Example:

"dev_2j4k2l2j3k4l2j3k4"

โ€‹
customer_id
string

Pengidentifikasi unik dari akun pelanggan pemilik gangguan ini.

Example:

"cus_1i2j3k4l5m6n7o8p"

โ€‹
microservice_id
string

Pengidentifikasi microservice yang melaporkan gangguan.

Example:

"wantunnel-monitor"

โ€‹
type
string

Kategori atau jenis gangguan.

Example:

"wantunnel"

โ€‹
status
enum<string>

Status gangguan saat ini.

Opsi yang tersedia:
unresolved,
resolved
Example:

"unresolved"

โ€‹
severity
enum<string>

Tingkat keparahan gangguan.

Opsi yang tersedia:
LOW,
MEDIUM,
HIGH,
CRITICAL,
WARNING
Example:

"CRITICAL"

โ€‹
message
string

Ringkasan singkat yang dapat dibaca manusia tentang gangguan.

Example:

"Failover tautan WAN: Tautan utama (WAN1) mati"

โ€‹
cause
string

Penjelasan rinci tentang kemungkinan penyebab gangguan.

Example:

"Probe gagal: Latensi melebihi ambang batas 500ms"

โ€‹
created_at
string<date-time>

Stempel waktu saat gangguan pertama kali terdeteksi dan dibuat.

Example:

"2025-10-21T12:00:00.000000Z"

โ€‹
resolved_at
string<date-time> | null

Stempel waktu saat gangguan diselesaikan. Null jika gangguan masih aktif.

Example:

null

โ€‹
resource_ancestry_path
string | null

String yang dipisahkan oleh | (pipe) yang mewakili lokasi hierarkis sumber daya, digunakan untuk memfilter gangguan berdasarkan sumber daya induk (misalnya, situs tertentu).

Example:

"site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"

โ€‹
ttl
integer | null

Stempel waktu Unix yang menunjukkan kapan catatan gangguan akan secara otomatis kedaluwarsa dari database.

Example:

1797825595

โ€‹
comments
object[]

Daftar komentar yang terkait dengan gangguan, diurutkan dari yang terlama hingga yang terbaru.