Runbook Library

Runbook Library

Koleksi prosedur operasional standar (SOP) untuk troubleshooting, provisioning, monitoring, dan pemulihan sistem. Setiap runbook bisa dijalankan secara manual atau diotomasi melalui AI Agent.

12

Total Runbook

9

Otomatis

6

Kategori

8 mnt

Avg. Waktu

Runbook Format

Setiap runbook di ConAI mengikuti format standar untuk memastikan konsistensi dan bisa diotomasi.

id

Identifier unik (lowercase, dash-case)

title

Judul runbook yang deskriptif

category

Kategori: network, provisioning, monitoring, security, ai-agent, database

severity

Level urgensi: low, medium, high, critical

estimated_time

Estimasi waktu eksekusi

steps[]

Daftar langkah berurutan dengan action, expected_result, dan rollback

triggers

Kondisi pemicu: alert, schedule, manual, atau agent_decision

automatable

Boolean — apakah bisa dijalankan otomatis oleh AI Agent

Kategori

Jaringan

3 runbook tersedia

Provisioning

3 runbook tersedia

Monitoring

2 runbook tersedia

Keamanan

2 runbook tersedia

AI Agent

1 runbook tersedia

Database

1 runbook tersedia

Semua Runbook

Klik runbook untuk melihat detail langkah-langkah eksekusi.

JaringanHighOtomatis

Reboot ONU Pelanggan via OLT

Prosedur reboot ONU/ONT pelanggan dari OLT untuk memulihkan koneksi fiber yang down atau intermittent.

5 menit7 langkah
ProvisioningMediumOtomatis

Throttling Bandwidth Pelanggan Tunggakan

Prosedur pembatasan bandwidth pelanggan yang memiliki tunggakan pembayaran lebih dari 7 hari.

3 menit5 langkah
JaringanHighOtomatis

Reset PPPoE Session di MikroTik

Prosedur reset sesi PPPoE pelanggan yang stuck atau tidak bisa connect ke internet.

4 menit6 langkah
MonitoringCriticalOtomatis

Eskalasi Alert Monitoring

Prosedur eskalasi alert dari monitoring system ke tim operasional ketika threshold terlampaui.

2 menit4 langkah
ProvisioningLowOtomatis

Onboarding Pelanggan ISP Baru

Prosedur end-to-end onboarding pelanggan ISP baru: dari registrasi hingga PPPoE aktif dan terverifikasi.

15 menit12 langkah
KeamananHigh

Audit Firewall Rules MikroTik

Prosedur audit dan pembersihan firewall rules MikroTik untuk memastikan keamanan dan performa optimal.

20 menit10 langkah
JaringanHigh

Investigasi Port Flap di OLT

Prosedur investigasi port yang flap (naik-turun) di OLT yang menyebabkan gangguan koneksi pelanggan.

10 menit8 langkah
AI AgentMediumOtomatis

Fallback Handling AI Agent

Prosedur ketika AI Agent tidak bisa menjawab pertanyaan pelanggan — eskalasi ke manusia dengan context lengkap.

1 menit3 langkah
DatabaseCriticalOtomatis

Verifikasi Backup Database Harian

Prosedur pengecekan backup database harian — pastikan backup terbaru tersedia, tidak corrupt, dan bisa di-restore.

10 menit6 langkah
ProvisioningMedium

Penanganan Sengketa Billing

Prosedur menangani keluhan pelanggan terkait tagihan — verifikasi penggunaan, bandingkan dengan paket, dan berikan solusi.

8 menit7 langkah
MonitoringCriticalOtomatis

Penanganan VPS Resource Exhaustion

Prosedur ketika VPS mencapai batas resource (CPU, RAM, disk) — identifikasi root cause dan langkah mitigasi.

15 menit9 langkah
KeamananCriticalOtomatis

Mitigasi DDoS pada Jaringan ISP

Prosedur identifikasi dan mitigasi serangan DDoS pada infrastruktur jaringan ISP menggunakan fitur ConAI.

5 menit6 langkah

Buat Custom Runbook

Anda bisa membuat runbook kustom melalui ConAI Dashboard atau API.

# Contoh: Custom Runbook via API
POST /api/v1/runbooks
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "id": "custom-maintenance-window",
  "title": "Maintenance Window — Router Upgrade",
  "category": "network",
  "severity": "medium",
  "estimated_time": "30 menit",
  "automatable": true,
  "triggers": ["manual", "schedule"],
  "steps": [
    {
      "order": 1,
      "action": "Notify affected customers via WhatsApp",
      "command": "conai notify --template maintenance --scope router:R1",
      "expected_result": "All customers receive maintenance notice",
      "rollback": null
    },
    {
      "order": 2,
      "action": "Backup current router config",
      "command": "conai provision backup --device R1",
      "expected_result": "Config backup stored in /backups/R1/",
      "rollback": null
    },
    {
      "order": 3,
      "action": "Disable PPPoE sessions gracefully",
      "command": "conai provision pppoe --device R1 --action disable",
      "expected_result": "All PPPoE sessions disconnected",
      "rollback": "conai provision pppoe --device R1 --action enable"
    },
    {
      "order": 4,
      "action": "Perform firmware upgrade",
      "command": "conai provision upgrade --device R1 --version 7.14",
      "expected_result": "Router rebooted with new firmware",
      "rollback": "conai provision restore --device R1 --backup latest"
    },
    {
      "order": 5,
      "action": "Verify all services restored",
      "command": "conai monitor check --device R1 --all",
      "expected_result": "All checks pass",
      "rollback": null
    }
  ]
}

Error Codes

CodeHTTP StatusDeskripsi
RUNBOOK_NOT_FOUND404Runbook dengan ID tidak ditemukan
STEP_EXECUTION_FAILED422Salah satu step gagal dieksekusi
ROLLBACK_FAILED500Rollback dari step yang gagal juga gagal
TRIGGER_INVALID400Trigger type tidak valid
RUNBOOK_ALREADY_RUNNING409Runbook sedang berjalan, tidak bisa di-eksekusi ulang
PERMISSION_DENIED403Tidak memiliki izin untuk menjalankan runbook

Runbook Automation

Runbook yang ditandai Otomatis bisa dijalankan langsung oleh AI Agent tanpa intervensi manusia. Agent akan mengeksekusi setiap step berurutan, memverifikasi expected result, dan melakukan rollback jika ada kegagalan. Untuk runbook manual, Agent akan menampilkan panduan step-by-step kepada operator.

← Documentation HubSkill Pack SDK →API Reference →