Документация

Ръководство за инсталация, конфигурация и поддръжка на Sofia.

Инсталация

Sofia се разпространява като един изпълним файл за Linux (amd64 и arm64). Изтеглете подходящата версия и я поставете в PATH:

curl -LO https://sofia.tetradexx.ru/dl/sofia-linux-amd64
install -m 0755 sofia-linux-amd64 /usr/local/bin/sofia
sofia version

Като systemd услуга

sofia service install
systemctl enable --now sofia

Конфигурация

Цялата конфигурация е във файл sofia.yaml. Пример:

interval: 30s
timeout: 10s
retries: 2

checks:
  - name: уеб сайт
    type: http
    url: https://example.com
    expect_status: 200
  - name: база данни
    type: tcp
    address: db.internal:5432

alerts:
  - type: telegram
    token: "..."
    chat_id: "..."

Видове проверки

ТипОписаниеОсновни полета
httpHTTP/HTTPS заявка с очакван кодurl, expect_status, method
tcpПроверка на отворен портaddress
tlsВалидност и срок на сертификатhost, warn_days
pingICMP наличностhost, count

Известия

Поддържат се имейл (SMTP), Telegram и произволен webhook. Съобщенията се групират, за да не се получават повторни известия при един и същ инцидент. Канал се задава в секцията alerts.

REST API

Вграденият API връща текущото състояние на проверките:

ПътМетодОписание
/api/v1/statusGETОбобщено състояние на услугата
/api/v1/checksGETСписък с проверки и резултати
/api/v1/historyGETИстория на наличността
curl -s https://sofia.tetradexx.ru/api/v1/status

Поддръжка