https://cozystack.ru/docs/v1.5/operations/services/monitoring/Recent content in Справочник Monitoring Hub on CozystackHugoenhttps://cozystack.ru/docs/v1.5/operations/services/monitoring/parameters/Mon, 01 Jan 0001 00:00:00 +0000https://cozystack.ru/docs/v1.5/operations/services/monitoring/parameters/<!-- Autogenerated content. Don't edit this file directly; edit sources instead. metadata: https://github.com/cozystack/website/blob/main/content/en/docs/v1.5/operations/services/_include/parameters.md source: https://github.com/cozystack/cozystack/blob/release-1.5/packages/extra/monitoring/README.md --> <h2 id="параметры">Параметры</h2> <h3 id="общие-параметры">Общие параметры</h3> <table> <thead> <tr> <th>Имя</th> <th>Описание</th> <th>Тип</th> <th>Значение</th> </tr> </thead> <tbody> <tr> <td><code>host</code></td> <td>Hostname для внешнего доступа к Grafana (по умолчанию subdomain <code>grafana</code> для host tenant).</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> </tbody> </table> <h3 id="конфигурация-metrics-storage">Конфигурация metrics storage</h3> <table> <thead> <tr> <th>Имя</th> <th>Описание</th> <th>Тип</th> <th>Значение</th> </tr> </thead> <tbody> <tr> <td><code>metricsStorages</code></td> <td>Конфигурация экземпляров metrics storage.</td> <td><code>[]object</code></td> <td><code>[...]</code></td> </tr> <tr> <td><code>metricsStorages[i].name</code></td> <td>Имя экземпляра storage.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].retentionPeriod</code></td> <td>Retention period для metrics.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].deduplicationInterval</code></td> <td>Deduplication interval для metrics.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].storage</code></td> <td>Размер persistent volume.</td> <td><code>string</code></td> <td><code>10Gi</code></td> </tr> <tr> <td><code>metricsStorages[i].storageClassName</code></td> <td>StorageClass, используемый для данных.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vminsert</code></td> <td>Конфигурация vminsert.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vminsert.minAllowed</code></td> <td>Минимальные гарантированные resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vminsert.minAllowed.cpu</code></td> <td>CPU request.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vminsert.minAllowed.memory</code></td> <td>Memory request.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vminsert.maxAllowed</code></td> <td>Максимально разрешенные resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vminsert.maxAllowed.cpu</code></td> <td>CPU limit.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vminsert.maxAllowed.memory</code></td> <td>Memory limit.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmselect</code></td> <td>Конфигурация vmselect.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vmselect.minAllowed</code></td> <td>Минимальные гарантированные resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vmselect.minAllowed.cpu</code></td> <td>CPU request.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmselect.minAllowed.memory</code></td> <td>Memory request.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmselect.maxAllowed</code></td> <td>Максимально разрешенные resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vmselect.maxAllowed.cpu</code></td> <td>CPU limit.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmselect.maxAllowed.memory</code></td> <td>Memory limit.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmstorage</code></td> <td>Конфигурация vmstorage.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vmstorage.minAllowed</code></td> <td>Минимальные гарантированные resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vmstorage.minAllowed.cpu</code></td> <td>CPU request.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmstorage.minAllowed.memory</code></td> <td>Memory request.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmstorage.maxAllowed</code></td> <td>Максимально разрешенные resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>metricsStorages[i].vmstorage.maxAllowed.cpu</code></td> <td>CPU limit.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>metricsStorages[i].vmstorage.maxAllowed.memory</code></td> <td>Memory limit.</td> <td><code>quantity</code></td> <td><code>&quot;&quot;</code></td> </tr> </tbody> </table> <h3 id="конфигурация-logs-storage">Конфигурация logs storage</h3> <table> <thead> <tr> <th>Имя</th> <th>Описание</th> <th>Тип</th> <th>Значение</th> </tr> </thead> <tbody> <tr> <td><code>logsStorages</code></td> <td>Конфигурация экземпляров logs storage.</td> <td><code>[]object</code></td> <td><code>[...]</code></td> </tr> <tr> <td><code>logsStorages[i].name</code></td> <td>Имя экземпляра storage.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>logsStorages[i].retentionPeriod</code></td> <td>Retention period для logs.</td> <td><code>string</code></td> <td><code>1</code></td> </tr> <tr> <td><code>logsStorages[i].storage</code></td> <td>Размер persistent volume.</td> <td><code>string</code></td> <td><code>10Gi</code></td> </tr> <tr> <td><code>logsStorages[i].storageClassName</code></td> <td>StorageClass, используемый для хранения данных.</td> <td><code>string</code></td> <td><code>replicated</code></td> </tr> </tbody> </table> <h3 id="конфигурация-alerta">Конфигурация Alerta</h3> <table> <thead> <tr> <th>Имя</th> <th>Описание</th> <th>Тип</th> <th>Значение</th> </tr> </thead> <tbody> <tr> <td><code>alerta</code></td> <td>Конфигурация сервиса Alerta.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>alerta.storage</code></td> <td>Размер persistent volume для database.</td> <td><code>string</code></td> <td><code>10Gi</code></td> </tr> <tr> <td><code>alerta.storageClassName</code></td> <td>StorageClass, используемый для database.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>alerta.resources</code></td> <td>Конфигурация resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>alerta.resources.requests</code></td> <td>Resource requests.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>alerta.resources.requests.cpu</code></td> <td>CPU request.</td> <td><code>quantity</code></td> <td><code>100m</code></td> </tr> <tr> <td><code>alerta.resources.requests.memory</code></td> <td>Memory request.</td> <td><code>quantity</code></td> <td><code>256Mi</code></td> </tr> <tr> <td><code>alerta.resources.limits</code></td> <td>Resource limits.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>alerta.resources.limits.cpu</code></td> <td>CPU limit.</td> <td><code>quantity</code></td> <td><code>1</code></td> </tr> <tr> <td><code>alerta.resources.limits.memory</code></td> <td>Memory limit.</td> <td><code>quantity</code></td> <td><code>1Gi</code></td> </tr> <tr> <td><code>alerta.alerts</code></td> <td>Конфигурация alert routing.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>alerta.alerts.telegram</code></td> <td>Конфигурация Telegram alerts.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>alerta.alerts.telegram.token</code></td> <td>Telegram bot token.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>alerta.alerts.telegram.chatID</code></td> <td>Telegram chat ID(s), разделенные запятыми.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>alerta.alerts.telegram.disabledSeverity</code></td> <td>Список severities без alerts, например [&ldquo;informational&rdquo;,&ldquo;warning&rdquo;].</td> <td><code>[]string</code></td> <td><code>[]</code></td> </tr> <tr> <td><code>alerta.alerts.slack</code></td> <td>Конфигурация Slack alerts.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>alerta.alerts.slack.url</code></td> <td>Configuration URI для Slack alerts.</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>alerta.alerts.slack.disabledSeverity</code></td> <td>Список severities без alerts, например [&ldquo;informational&rdquo;,&ldquo;warning&rdquo;].</td> <td><code>[]string</code></td> <td><code>[]</code></td> </tr> </tbody> </table> <h3 id="конфигурация-grafana">Конфигурация Grafana</h3> <table> <thead> <tr> <th>Имя</th> <th>Описание</th> <th>Тип</th> <th>Значение</th> </tr> </thead> <tbody> <tr> <td><code>grafana</code></td> <td>Конфигурация Grafana.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>grafana.db</code></td> <td>Конфигурация database.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>grafana.db.size</code></td> <td>Размер persistent volume для database.</td> <td><code>string</code></td> <td><code>10Gi</code></td> </tr> <tr> <td><code>grafana.resources</code></td> <td>Конфигурация resources.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>grafana.resources.requests</code></td> <td>Resource requests.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>grafana.resources.requests.cpu</code></td> <td>CPU request.</td> <td><code>quantity</code></td> <td><code>100m</code></td> </tr> <tr> <td><code>grafana.resources.requests.memory</code></td> <td>Memory request.</td> <td><code>quantity</code></td> <td><code>256Mi</code></td> </tr> <tr> <td><code>grafana.resources.limits</code></td> <td>Resource limits.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>grafana.resources.limits.cpu</code></td> <td>CPU limit.</td> <td><code>quantity</code></td> <td><code>1</code></td> </tr> <tr> <td><code>grafana.resources.limits.memory</code></td> <td>Memory limit.</td> <td><code>quantity</code></td> <td><code>1Gi</code></td> </tr> </tbody> </table> <h3 id="конфигурация-vmagent">Конфигурация Vmagent</h3> <table> <thead> <tr> <th>Имя</th> <th>Описание</th> <th>Тип</th> <th>Значение</th> </tr> </thead> <tbody> <tr> <td><code>vmagent</code></td> <td>Конфигурация VictoriaMetrics Agent.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>vmagent.externalLabels</code></td> <td>External labels, применяемые ко всем metrics.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> <tr> <td><code>vmagent.remoteWrite</code></td> <td>Конфигурация remote write.</td> <td><code>object</code></td> <td><code>{}</code></td> </tr> </tbody> </table>https://cozystack.ru/docs/v1.5/operations/services/monitoring/setup/Mon, 01 Jan 0001 00:00:00 +0000https://cozystack.ru/docs/v1.5/operations/services/monitoring/setup/<h2 id="обзор">Обзор</h2> <p>Cozystack предоставляет комплексную систему monitoring и alerting для Kubernetes-кластеров и приложений. Система основана на Victoria Metrics для хранения метрик и логов, Grafana для визуализации, Alerta для оповещений и WorkloadMonitor для мониторинга состояния приложений.</p> <p>Архитектура разделена на два уровня:</p> <ul> <li><strong>Системный уровень</strong>: мониторинг инфраструктуры кластера</li> <li><strong>Уровень tenant</strong>: изолированный мониторинг для каждого tenant</li> </ul> <h2 id="установка-мониторинга">Установка мониторинга</h2> <h3 id="системный-monitoring">Системный monitoring</h3> <p>System monitoring устанавливается автоматически при развертывании платформы через HelmRelease <code>monitoring-agents</code> в <code>packages/apps/kubernetes/templates/helmreleases/monitoring-agents.yaml</code>.</p> <p>Для ручной установки через локальный chart:</p>https://cozystack.ru/docs/v1.5/operations/services/monitoring/dashboards/Mon, 01 Jan 0001 00:00:00 +0000https://cozystack.ru/docs/v1.5/operations/services/monitoring/dashboards/<h2 id="обзор">Обзор</h2> <p>Cozystack интегрирует Grafana как основной инструмент визуализации метрик, собираемых VictoriaMetrics (VM). В этом разделе описан доступ к предварительно настроенным дашбордам, создание собственных визуализаций и подключение внешних источников данных для полноценной наблюдаемости кластеров и приложений Cozystack.</p> <h2 id="доступ-к-grafana">Доступ к Grafana</h2> <p>Чтобы открыть Grafana и посмотреть дашборды:</p> <ol> <li>Перейдите по URL Grafana: <code>https://grafana.&lt;tenant-domain&gt;</code>, где <code>&lt;tenant-domain&gt;</code> - домен вашего tenant.</li> <li>Войдите в систему, используя учётные данные tenant (OIDC или token-based authentication).</li> <li>После входа предварительно настроенные дашборды доступны в разделе &ldquo;Dashboards&rdquo;.</li> </ol> <p>Первичную настройку и детали конфигурации см. в <a href="https://cozystack.ru/docs/v1.5/operations/services/monitoring/setup/" target="_blank">Monitoring Setup</a>.</p>https://cozystack.ru/docs/v1.5/operations/services/monitoring/logs/Mon, 01 Jan 0001 00:00:00 +0000https://cozystack.ru/docs/v1.5/operations/services/monitoring/logs/<h2 id="сбор-и-хранение-логов">Сбор и хранение логов</h2> <p>Cozystack использует Fluent Bit для сбора логов и VictoriaLogs для хранения и запросов. Логи собираются из разных источников внутри кластера и хранятся в выделенных log storages, настроенных для каждого tenant.</p> <h3 id="настройка-logs-storages">Настройка logs storages</h3> <p>Log storages настраиваются через параметры monitoring hub. У каждого tenant может быть несколько экземпляров log storage с настраиваемыми периодами хранения и размерами хранилища.</p> <table> <thead> <tr> <th>Параметр</th> <th>Описание</th> <th>Тип</th> <th>По умолчанию</th> </tr> </thead> <tbody> <tr> <td><code>logsStorages</code></td> <td>Массив конфигураций log storage</td> <td><code>[]object</code></td> <td><code>[]</code></td> </tr> <tr> <td><code>logsStorages[i].name</code></td> <td>Имя экземпляра storage</td> <td><code>string</code></td> <td><code>&quot;&quot;</code></td> </tr> <tr> <td><code>logsStorages[i].retentionPeriod</code></td> <td>Период хранения для логов, например &ldquo;30d&rdquo;</td> <td><code>string</code></td> <td><code>&quot;1&quot;</code></td> </tr> <tr> <td><code>logsStorages[i].storage</code></td> <td>Размер persistent volume</td> <td><code>string</code></td> <td><code>&quot;10Gi&quot;</code></td> </tr> <tr> <td><code>logsStorages[i].storageClassName</code></td> <td>StorageClass для хранения данных</td> <td><code>string</code></td> <td><code>&quot;replicated&quot;</code></td> </tr> </tbody> </table> <p>Подробные параметры конфигурации см. в <a href="https://cozystack.ru/docs/v1.5/operations/services/monitoring/" target="_blank">Monitoring Hub Reference</a>.</p>https://cozystack.ru/docs/v1.5/operations/services/monitoring/custom-metrics/Mon, 01 Jan 0001 00:00:00 +0000https://cozystack.ru/docs/v1.5/operations/services/monitoring/custom-metrics/<h2 id="обзор">Обзор</h2> <p>Tenant monitoring в Cozystack поддерживает сбор пользовательских метрик из ваших приложений и экспортеров. Tenant VMAgent обнаруживает таргеты для сбора метрик по меткам namespace Kubernetes, что позволяет подключать к мониторингу любые приложения., которое предоставляет Prometheus-compatible endpoint <code>/metrics</code>.</p> <p>В этом руководстве показано, как создать ресурсы <code>VMServiceScrape</code> и <code>VMPodScrape</code>, чтобы tenant VMAgent собирал ваши пользовательские метрики и делал их доступными в Grafana.</p> <h2 id="предварительные-требования">Предварительные требования</h2> <ul> <li>Monitoring включен для вашего tenant (см. <a href="https://cozystack.ru/docs/v1.5/operations/services/monitoring/setup/">Monitoring Setup</a>)</li> <li>Ваше приложение или экспортеры развернуты и предоставляют совместимый с Prometheus ендпоинт <code>/metrics</code></li> <li>У вас есть доступ к кластеру через <code>kubectl</code></li> </ul> <h2 id="использование-vmservicescrape">Использование VMServiceScrape</h2> <p><code>VMServiceScrape</code> указывает tenant VMAgent собирать метрики с ендпоинта за Kubernetes Service.</p>https://cozystack.ru/docs/v1.5/operations/services/monitoring/alerting/Mon, 01 Jan 0001 00:00:00 +0000https://cozystack.ru/docs/v1.5/operations/services/monitoring/alerting/<h2 id="обзор">Обзор</h2> <p>Система оповещения в Cozystack объединяет Prometheus, Alertmanager и Alerta, обеспечивая полноценный мониторинг и уведомления. Alerts создаются на основе метрик, собранных VMAgent и сохраненных в VMCluster, затем Alertmanager группирует их и устраняет дубликаты, после чего Alerta управляет отправкой уведомлений по различным каналам, например Telegram и Slack.</p> <h3 id="поток-alerting">Поток alerting</h3> <pre class="mermaid">sequenceDiagram participant P as Prometheus participant AM as Alertmanager participant A as Alerta participant T as Telegram participant S as Slack P-&gt;&gt;AM: Send Alert AM-&gt;&gt;A: Forward Alert A-&gt;&gt;T: Send Notification A-&gt;&gt;S: Send Notification</pre> <h2 id="настройка-alerts-в-alerta">Настройка alerts в Alerta</h2> <p>Alerta - это система оповещения, интегрированная в стек мониторинга Cozystack. Она обрабатывает алерты из разных источников и отправляет оповещения через несколько каналов.</p>