Memulai Cepat
AINAV Agent

Memulai Cepat: AINAV Agent

AINAV Agent Documentation

Memulai Cepat: AINAV Agent

Panduan ringkas untuk memahami fungsi AINAV Agent dan memasangnya pada server Linux atau Virtual Machine Anda dalam hitungan menit.

Linux 64-bit systemd HTTPS / TLS 1.3

Daftar Isi

AINAV Agent Linux

Lightweight monitoring agent yang berjalan langsung pada sistem operasi server.

Dokumentasi AINAV

Overview AINAV Agent

Apa itu AINAV Agent?

AINAV Agent adalah daemon pemantau (lightweight monitoring agent) yang dipasang langsung di dalam sistem operasi server seperti VPS, Cloud VM, atau server baremetal.

Tugas utamanya adalah mengumpulkan telemetri sistem operasi secara real-time dan mengirimkannya secara aman ke AINAV Cloud Platform agar status server dapat dipantau dari satu dasbor terpusat.

Metrik & Fungsi Utama

Resource Real-Time

Memantau CPU, RAM, kapasitas & I/O disk, serta throughput jaringan.

Sistem Peringatan Dini

Mendeteksi indikasi lonjakan beban, risiko Out of Memory, dan disk yang mendekati penuh.

Eksekusi Terisolasi

Menerima instruksi automasi terenkripsi dari dashboard AINAV tanpa membuka port SSH publik.

Architecture Secure Connection

Cara Kerja AINAV Agent

AINAV Agent berjalan di dalam server dan mengirimkan telemetri ke AINAV Cloud melalui koneksi outbound yang aman.

Server / Virtual Machine

Linux 64-bit

ACTIVE

Workloads

Aplikasi Bisnis / Web / Database

AINAV Agent Daemon

Lightweight Monitoring Agent

Resource

RAM ~20 MB

CPU

< 0.5%

Network Model

100% Egress-Only

↓

HTTPS / TLS 1.3

Outbound TCP Port 443

↓

AINAV Cloud Platform

ainav.id

Monitoring Telemetry Dashboard

Egress-Only Connection

AINAV Agent menggunakan koneksi keluar melalui TCP Port 443. Tidak diperlukan port inbound terbuka untuk komunikasi dengan platform.

Prerequisites

Kebutuhan Sistem

Pastikan server memenuhi persyaratan minimal berikut sebelum memasang AINAV Agent.

Operating System

Linux 64-bit

x86_64 / amd64

Ubuntu 20.04–24.04 Debian 10–12 RHEL / Rocky / AlmaLinux

System Init

systemd

Sistem init diperlukan untuk mengelola service AINAV Agent.

Access

Root / sudo

Gunakan akun root atau akun dengan hak akses sudo.

Minimum Resource

512 MB RAM · 1 Core

Disk kosong sekitar 150 MB. Alokasi agent sekitar 20 MB RAM.

Koneksi Internet Outbound

Server harus memiliki akses koneksi keluar TCP Port 443 ke internet. Tidak diperlukan port masuk atau inbound open port untuk koneksi agent.

CLI

Perintah Pengelolaan Dasar

Gunakan perintah berikut untuk memelihara atau mengelola service AINAV Agent.

Tindakan	Perintah Terminal
Melihat Log Real-Time	`sudo journalctl -u ainav-agent -f`
Restart Layanan	`sudo systemctl restart ainav-agent`
Hentikan Layanan	`sudo systemctl stop ainav-agent`
Mulai Layanan	`sudo systemctl start ainav-agent`

Troubleshooting

Pemecahan Masalah Cepat

Beberapa kendala umum dan tindakan yang dapat dilakukan untuk melakukan pemeriksaan awal.

Kendala	Kemungkinan Penyebab	Tindakan Solusi
Service `auto-restart` terus menerus	Token agen kosong atau format salah pada file konfigurasi.	Periksa token di `/opt/ainav/.env` lalu simpan dan jalankan: `sudo systemctl restart ainav-agent`
Koneksi Timeout saat install	Firewall server memblokir akses keluar pada port 443.	Pastikan server dapat mengakses URL rilis menggunakan: `curl -I https://get.ainav.id`
Perintah `ainav-agent` tidak ditemukan	Shortcut CLI belum terpasang di direktori binary sistem.	Jalankan langsung menggunakan path penuh: `/opt/ainav/venv/bin/python3 -m router.main --doctor`

AINAV Agent

Hubungkan Server Anda dengan AINAV

Pasang AINAV Agent pada server Linux Anda untuk mengirimkan telemetri dan menghubungkan server dengan AINAV Cloud Platform.

Open AINAV