> ## 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 Zabbix monitoring to CloudThinker for infrastructure monitoring, alerting, and performance analysis

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

***

## Supported Platforms

| Platform         | Support                                              |
| ---------------- | ---------------------------------------------------- |
| **Zabbix**       | 4.4+ (username/password auth), 5.4+ (API token auth) |
| **Zabbix Cloud** | All tiers                                            |

***

## Setup

<Steps>
  <Step title="Open Zabbix">
    Sign in to your Zabbix frontend as an administrator.
  </Step>

  <Step title="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).
  </Step>

  <Step title="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.

    <Warning>
      API tokens require Zabbix 5.4 or later.
    </Warning>
  </Step>

  <Step title="Find Your Zabbix URL">
    Your Zabbix URL is the address of your Zabbix frontend, e.g., `https://zabbix.your-domain.com`.
  </Step>

  <Step title="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
  </Step>
</Steps>

***

## Connection Details

| Field                  | Description                        | Example                          |
| ---------------------- | ---------------------------------- | -------------------------------- |
| **ZABBIX\_URL**        | Your Zabbix frontend URL           | `https://zabbix.your-domain.com` |
| **ZABBIX\_AUTH\_TYPE** | Authentication method              | `credentials` or `token`         |
| **ZABBIX\_USERNAME**   | Zabbix username (credentials auth) | `cloudthinker`                   |
| **ZABBIX\_PASSWORD**   | Zabbix password (credentials auth) | `your-secure-password`           |
| **ZABBIX\_TOKEN**      | Zabbix 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

### Recommended (Full Operations)

* **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:

| Capability              | Description                                                  |
| ----------------------- | ------------------------------------------------------------ |
| **Host Management**     | List, inspect, enable, and disable monitored hosts           |
| **Problem Analysis**    | Retrieve active problems, analyze patterns, correlate events |
| **Trigger Management**  | View and modify alert trigger configurations                 |
| **Maintenance Windows** | Create and manage maintenance periods to suppress alerts     |
| **Template Operations** | Inspect and apply monitoring templates across hosts          |
| **Dashboard Access**    | Retrieve Zabbix dashboards and graph data                    |

### Example Prompts

```bash theme={null}
@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

<Accordion title="Connection refused">
  * 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
</Accordion>

<Accordion title="Authentication failed">
  * 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
</Accordion>

<Accordion title="Permission denied">
  * 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
</Accordion>

<Accordion title="API token expired">
  * Go to **Users → API Tokens** in Zabbix
  * Delete the expired token and create a new one
  * Update the token in CloudThinker connection settings
</Accordion>

***

## 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

***

## Related

<CardGroup cols={2}>
  <Card title="Grafana Connection" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/grafana.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c1329049025cd3c3a0909b400baef7be" href="/guide/connections/grafana" width="24" height="24" data-path="images/icons/grafana.svg">
    Visualize Zabbix metrics in Grafana
  </Card>

  <Card title="Elasticsearch Connection" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/elasticsearch.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c7389cfcd0bc8d303aeeb68bd19199ca" href="/guide/connections/elasticsearch" width="24" height="24" data-path="images/icons/elasticsearch.svg">
    Forward Zabbix logs to Elasticsearch
  </Card>
</CardGroup>