mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-23 13:05:47 +00:00
177 lines
6.4 KiB
Plaintext
177 lines
6.4 KiB
Plaintext
|
# 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 ""
|
||
|
|
|