Pinguva is a SaaS infrastructure monitoring platform for IT outsourcing teams, web studios, system administrators, product teams, and companies managing multiple servers and customer projects.
The Pinguva platform monitors websites, APIs, TCP services, Ping availability, TLS certificates, domains, and server telemetry through lightweight Linux and Windows agents. Synthetic website, API, TCP, Ping, TLS, and domain checks are platform capabilities. The agent collects local server telemetry and reports it to Pinguva.
For self-hosted Bitrix24 installations, Pinguva Agent provides privacy-safe REST and MySQL diagnostics. It does not send webhook secrets, MySQL passwords, CRM records, raw access logs, source SQL values, configuration-file contents, or HTTP request and response bodies to the Pinguva platform.
Pinguva Agent provides the following confirmed capabilities:
- Versioned Linux and Windows agent source snapshots.
- Server telemetry collection for CPU, memory, disk, network, uptime, and Ping.
- Linux Disk I/O, watched-service, and configuration-change telemetry.
- Outbound reporting to the configured Pinguva endpoint. The agent does not open inbound listening ports.
- No remote command execution from the Pinguva platform. The agent may invoke local operating-system utilities only for its own collection and service-management tasks.
- Local Bitrix24 REST checks and self-hosted Bitrix24 load diagnostics on supported Linux installations.
- Public integration guides, troubleshooting runbooks, and API Collector examples.
In the documented production configuration, the agent communicates with Pinguva over outbound HTTPS. Development and test configuration can use a separately configured local HTTP endpoint.
Pinguva Agent helps technical teams investigate load on self-hosted Bitrix24 by collecting local technical aggregates for REST activity and MySQL. It provides diagnostic data that helps identify likely sources of load and investigate short-lived incidents. It does not claim to determine the exact cause of every incident automatically.
For a compatible, locally configured Bitrix24 installation, version 0.2.12 can collect:
- REST request activity, 5xx counts, and route aggregates without query strings.
- REST method availability and latency for selected profiles.
- MySQL connection and activity counters, including
Threads_runningand active-query metrics when available. - Long-running query categories, SQL digest aggregates, examined-row counters, no-index markers, and supported lock-wait information.
- Minute-level diagnostic history and load incidents.
The webhook remains only on the customer server. MySQL credentials remain local. Pinguva receives bounded technical aggregates only. The agent does not send CRM records, raw access-log lines, original SQL text or values, HTTP bodies, configuration-file contents, Bitrix24 webhook secrets, or MySQL passwords. A normalized SELECT structure is sent only when safe redaction succeeds; otherwise only the digest, category, and counters are sent.
- The agent does not accept inbound network connections.
- It reports outward to Pinguva and does not expose a control endpoint for remote commands.
- Bitrix24 webhooks and MySQL credentials are stored and used locally on the customer server.
- The agent does not transmit configuration-file contents. Configuration monitoring reports bounded metadata and a SHA-256 fingerprint rather than file content.
- Bitrix24 diagnostics use aggregates and redacted data. Raw access logs, CRM data, raw SQL values, and HTTP request or response bodies are excluded.
See Security Policy and Privacy Notes for the detailed scope.
This repository contains:
- Release-specific source snapshots of Pinguva Agent.
- Linux and Windows agent source code in each snapshot.
- Security, privacy, and license documents.
- Bitrix24 local integration documentation.
- Agent troubleshooting runbooks.
- API Collector integration documentation and examples for Node.js, PHP, and FastAPI.
Each version directory is self-contained and includes its own go.mod, README, license, security notes, privacy notes, and changelog.
This repository contains the source code of the Pinguva monitoring agent for transparency and security review.
The Pinguva SaaS backend, web application, internal server-side logic, alerting infrastructure, and commercial platform components are not included and remain closed-source.
Pinguva Agent is not the complete Pinguva SaaS platform and this repository does not provide a self-hosted Pinguva backend.
The latest published source snapshot is 0.2.12. It is also published as Pinguva Agent v0.2.12.
Confirmed additions in 0.2.12 include minute-level self-hosted Bitrix24 REST and MySQL aggregates, bounded local buffering of unsent diagnostics, optional MySQL lock-wait metrics, safe SQL-digest aggregation, and compatibility with an older Pinguva backend that does not support the optional diagnostics endpoint. See 0.2.12/CHANGELOG.md for release-specific details.
- Bitrix24 Local Integration
- API Collector Integration
- Agent Troubleshooting Runbook
- API Collector examples
- Documentation index and Russian documentation
Read CONTRIBUTING.md before opening a public issue or pull request. Do not put webhook URLs, tokens, passwords, customer data, raw logs, or security-vulnerability details into public reports.
Русская документация сохранена в docs/ru. Для обзора всех публичных документов используйте docs/README.md.