Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Zabbix

Connect your Zabbix monitoring platform to enable CloudThinker agents to manage hosts, analyze problems, handle maintenance windows, and perform infrastructure monitoring operations.

​
Supported Platforms

PlatformSupport
Zabbix4.4+ (username/password auth), 5.4+ (API token auth)
Zabbix CloudAll tiers

​
Setup

1

Open Zabbix

Sign in to your Zabbix frontend as an administrator.
2

Create a Dedicated User (Recommended)

Go to Users → Users and create a new user:
  • Username: cloudthinker
  • Password: A strong, unique password
  • Role: Super Admin role (required for full API access) or a custom role with API access enabled
Alternatively, generate an API token (see next step).
3

Generate an API Token (Optional)

Go to Administration → General → API Tokens and click Create API token:
  • Name: cloudthinker
  • User: Select the user created above
  • Expires at: Set an appropriate expiration date
Copy the token — it will not be shown again.
API tokens require Zabbix 5.4 or later.
4

Find Your Zabbix URL

Your Zabbix URL is the address of your Zabbix frontend, e.g., https://zabbix.your-domain.com.
5

Add Connection in CloudThinker

Navigate to Connections → Zabbix and enter:
  • Zabbix URL: Your Zabbix frontend URL
  • Auth Type: Select Username & Password or API Token
  • Username / Password or API Token: The credentials created above

​
Connection Details

FieldDescriptionExample
ZABBIX_URLYour Zabbix frontend URLhttps://zabbix.your-domain.com
ZABBIX_AUTH_TYPEAuthentication methodcredentials or token
ZABBIX_USERNAMEZabbix username (credentials auth)cloudthinker
ZABBIX_PASSWORDZabbix password (credentials auth)your-secure-password
ZABBIX_TOKENZabbix API token (token auth)abc123...

​
Required Permissions

​
Minimum (Read-Only Monitoring)

  • User role with Zabbix API access enabled
  • Read access to host groups you want to monitor
  • Super Admin role or a custom role with:
    • API access enabled
    • Read/write access to hosts, templates, triggers, and events
    • Permission to create and modify maintenance windows

​
Agent Capabilities

Once connected, agents can:
CapabilityDescription
Host ManagementList, inspect, enable, and disable monitored hosts
Problem AnalysisRetrieve active problems, analyze patterns, correlate events
Trigger ManagementView and modify alert trigger configurations
Maintenance WindowsCreate and manage maintenance periods to suppress alerts
Template OperationsInspect and apply monitoring templates across hosts
Dashboard AccessRetrieve Zabbix dashboards and graph data

​
Example Prompts

@alex list all Zabbix hosts with active problems and their severity
@alex create a 2-hour maintenance window for the production host group
@alex analyze active problems with severity >= High and recommend remediation
@oliver review trigger configurations for security-related alerts

​
Troubleshooting

  • Verify the Zabbix URL is accessible from CloudThinker
  • Check firewall rules allow inbound connections on port 80/443
  • Ensure the Zabbix frontend is running and responding
  • Verify username and password are correct
  • Check the user account is not locked or disabled
  • For API token auth: verify the token has not expired
  • Ensure the user has API access enabled in their role
  • Verify the user has sufficient permissions for the requested operations
  • Check host group access is granted to the user
  • For write operations: ensure the role permits API write access
  • Go to Users → API Tokens in Zabbix
  • Delete the expired token and create a new one
  • Update the token in CloudThinker connection settings

​
Security Best Practices

  • Dedicated user - Create a dedicated Zabbix user for CloudThinker
  • API token preferred - Use API tokens instead of username/password for better auditability
  • Token expiration - Set appropriate expiration dates on API tokens
  • Minimal permissions - Grant only the host groups and permissions needed
  • HTTPS only - Always use HTTPS for your Zabbix frontend URL
  • Token rotation - Rotate API tokens every 90 days

Grafana Connection

Visualize Zabbix metrics in Grafana

Elasticsearch Connection

Forward Zabbix logs to Elasticsearch