matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-prometheus-nginxlog.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
# members
# This file is distributed under the same license as the
# matrix-docker-ansible-deploy package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: matrix-docker-ansible-deploy \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: bg\n"
"Language-Team: bg <LL@li.org>\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.16.0\n"

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:1
msgid "Enabling metrics and graphs for NginX logs (optional)"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:3
msgid ""
"It can be useful to have some (visual) insight into "
"[nginx](https://nginx.org/) logs."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:5
msgid ""
"This adds [prometheus-nginxlog-exporter](https://github.com/martin-"
"helmich/prometheus-nginxlog-exporter/) to your Matrix deployment."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:7
msgid ""
"It will collect access logs from various nginx reverse-proxies which may "
"be used internally (e.g. `matrix-synapse-reverse-proxy-companion`, if "
"Synapse workers are enabled) and will make them available at a "
"Prometheus-compatible `/metrics` endpoint."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:9
msgid ""
"**Note**: nginx is only used internally by this Ansible playbook. With "
"Traefik being our default reverse-proxy, collecting nginx metrics is less"
" relevant."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:11
msgid ""
"To make use of this, you need to install [Prometheus](./configuring-"
"playbook-prometheus-grafana.md) either via the playbook or externally. "
"When using an external Prometheus, configuration adjustments are "
"necessary - see [Save metrics on an external Prometheus server](#save-"
"metrics-on-an-external-prometheus-server)."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:13
msgid ""
"If your setup includes [Grafana](./configuring-playbook-prometheus-"
"grafana.md), a dedicated `NGINX PROXY` Grafana dashboard will be created."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:15
msgid "Configuration"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:17
msgid ""
"Add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:23
msgid "Installing"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:25
msgid ""
"After configuring the playbook, run it with [playbook tags](playbook-"
"tags.md) as below:"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:32
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:34
msgid ""
"`just install-all` is useful for maintaining your setup quickly ([2x-5x "
"faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
"runtime) than `just setup-all`) when its components remain unchanged. If "
"you adjust your `vars.yml` to remove other components, you'd need to run "
"`just setup-all`, or these components will still remain installed. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:36
msgid "Docker Image Compatibility"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:38
msgid ""
"At the moment of writing only images for `amd64` and `arm64` "
"architectures are available. The playbook currently does not support "
"[self-building](./self-building.md) a container image on other "
"architectures. You can however use a custom-build image by setting:"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:45
msgid "Security and privacy"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:47
msgid ""
"Metrics and resulting graphs can contain a lot of information. NginX logs"
" contain information like IP address, URLs, UserAgents and more. This "
"information can reveal usage patterns and could be considered Personally "
"Identifiable Information (PII). Think about this before enabling "
"(anonymous) access. Please make sure you change the default Grafana "
"password."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:49
msgid "Save metrics on an external Prometheus server"
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:51
msgid ""
"The playbook will automatically integrate the metrics into the "
"[Prometheus](./configuring-playbook-prometheus-grafana.md) server "
"provided with this playbook (if enabled). In such cases, the metrics "
"endpoint is not exposed publicly - it's only available on the container "
"network."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:53
msgid ""
"When using an external Prometheus server, you'll need to expose metrics "
"publicly. See [Collecting metrics to an external Prometheus server"
"](./configuring-playbook-prometheus-grafana.md#collecting-metrics-to-an-"
"external-prometheus-server)."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:55
msgid ""
"You can either use "
"`matrix_prometheus_nginxlog_exporter_metrics_proxying_enabled: true` to "
"expose just this one service, or `matrix_metrics_exposure_enabled: true` "
"to expose all services."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:57
msgid ""
"Whichever way you go with, this service will expose its metrics endpoint "
"**without password-protection** at "
"`https://matrix.example.com/metrics/nginxlog` by default."
msgstr ""

#: ../../../docs/configuring-playbook-prometheus-nginxlog.md:59
msgid ""
"For password-protection, use "
"(`matrix_metrics_exposure_http_basic_auth_enabled` and "
"`matrix_metrics_exposure_http_basic_auth_users`) or "
"(`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_enabled`"
" and "
"`matrix_prometheus_nginxlog_exporter_container_labels_metrics_middleware_basic_auth_users`)."
msgstr ""