History

Andreas Hilbig b646b8c606 feat: optimize Zabbix queries and enhance specialized device support - Implement query optimization (reduced output, parameter skipping) to minimize Zabbix API traffic. - Add indirect dependency handling: deviceType implies tags and state implies items. - Move schema extensions to samples/extensions/ to clarify their role as samples. - Enhance DistanceTrackerDevice with String time fields to support optional date portions. - Ensure allDevices strictly filters by deviceType and populates the field in results. - Refactor runAllRegressionTests mutation to use internal unique names and improve stability. - Fix unnecessary Zabbix API calls for item preprocessing during template and host imports. - Update documentation including cookbook recipes, test specifications, and optimization guides. - Add extensive unit, integration, and regression tests covering all implemented changes. - Update docker-compose.yml to mount the samples/ directory as a volume. - Update IntelliJ .idea run configurations to reflect the new sample extension paths.		2026-02-02 13:20:06 +01:00
..
cookbook.md	feat: optimize Zabbix queries and enhance specialized device support	2026-02-02 13:20:06 +01:00
hierarchical_data_mapping.md	chore: add MCP integration and refactor documentation into modular how-to guides	2026-01-30 00:47:02 +01:00
maintenance.md	feat: implement comprehensive testing framework and regression suite	2026-02-01 05:05:55 +01:00
mcp.md	feat: implement comprehensive testing framework and regression suite	2026-02-01 05:05:55 +01:00
permissions.md	docs: refactor documentation and upgrade to Node.js 24	2026-01-30 14:35:31 +01:00
query_optimization.md	feat: optimize Zabbix queries and enhance specialized device support	2026-02-02 13:20:06 +01:00
README.md	feat(query-optimization): implement GraphQL query optimization and enhance regression suite	2026-02-02 06:23:35 +01:00
schema.md	feat: optimize Zabbix queries and enhance specialized device support	2026-02-02 13:20:06 +01:00
tags.md	docs: refactor documentation and upgrade to Node.js 24	2026-01-30 14:35:31 +01:00

README.md

How-To Guides

This directory contains detailed guides on how to use and extend the Zabbix GraphQL API.

Available Guides

🍳 Cookbook

Practical, step-by-step recipes for common tasks, designed for both humans and AI-based test generation.

⚡ Query Optimization

Learn how the API optimizes Zabbix requests by reducing output fields and skipping unnecessary parameters based on the GraphQL query.

📊 Schema and Schema Extension

Learn about the GraphQL schema structure, how Zabbix entities map to GraphQL types, and how to use the dynamic schema extension system.

🗂️ Hierarchical Data Mapping

Understand how the API automatically maps flat Zabbix item keys into nested GraphQL objects using hierarchical resolvers and type hinting.

🔐 Roles and Permissions Extension

Discover how the permission system works, how to define permission levels using Zabbix template groups, and how to query user permissions.

🛠️ Technical Maintenance

Guide on code generation (GraphQL Codegen), running Jest tests, and local Docker builds.

🧪 Test Specification

Detailed list of test cases, categories (Unit, Integration, E2E), and coverage checklist.

🤖 MCP & Agent Integration

Discover how to integrate with the Model Context Protocol (MCP) to enable LLMs and autonomous agents to interact with Zabbix efficiently.

🔍 Additional Resources

Sample Queries: Categorized list of practical GraphQL operation examples.
Main README: Technical reference, configuration, and environment setup.