|
- # 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: jp\n"
- "Language-Team: jp <LL@li.org>\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 ""
|