Reference

SafeCall Config Keys (Bridge + Zabbix)

Key	Purpose
server_features	Must include bridge on bridge runtime
server_bridge_server_url	Base URL of main SafeCall server exposing /lld/*
server_bridge_endpoint_gateway	LLD gateway endpoint path
server_bridge_endpoint_beacon	LLD beacon endpoint path
server_bridge_zabbix_host	Zabbix trapper host
server_bridge_zabbix_port	Zabbix trapper port (default 10051)
server_bridge_delay_gateway	Gateway update throttle seconds
server_bridge_delay_beacon	Beacon update throttle seconds
server_bridge_cache_update_interval	LLD cache refresh interval seconds
server_bridge_debug_enabled	Enables bridge debug logs/counters
server_bridge_debug_sample_rate	Debug log sampling ratio (1 = all)
server_bridge_debug_snapshot_interval	Health snapshot interval seconds

LLD Endpoints

Endpoint	Source	Notes
/lld/gateways	main SafeCall server	gateway discovery macros
/lld/beacons	main SafeCall server	beacon discovery macros

Trapper Item Keys Sent By Bridge

Gateway

• wtgateway.temperature
• wtgateway.load
• wtgateway.last_seen

Beacon

• wtbeacon.battery
• wtbeacon.temperature
• wtbeacon.humidity
• wtbeacon.pressed
• wtbeacon.last_seen

CLI Commands

Setup / Reconcile Objects

./util.sh integrations zabbix setup --url "http://<zabbix>/api_jsonrpc.php" --user Admin
./util.sh integrations zabbix setup --dry-run

Doctor (SafeCall-side diagnostics)

./util.sh integrations zabbix doctor

Checks LLD reachability, payload validity, bridge config basics, and trapper TCP reachability.

Verify (read-only Zabbix API checks)

./util.sh integrations zabbix verify --url "http://<zabbix>/api_jsonrpc.php" --user Admin

Checks API/auth/host/discovery/template/item/trigger/prototype presence without modifying objects.

When host lookup fails, verify prints candidate host names returned by host.get.

API Auth Transport Notes

• Newer Zabbix versions (for example 7.x) expect token auth through the Authorization header.
• Older versions may still accept legacy JSON-RPC auth field.
• SafeCall CLI auto-detects/fallbacks between these modes.

Common Failure Buckets

• mqtt_intake: bridge receives nothing useful from broker
• lld_fetch: bridge cannot load discovery cache from main server
• mapping: MQTT MAC not present in current bridge cache
• zabbix_send: queue created but trapper delivery fails