Merge 3.11 into 3.10

github-actions · github-actions · commit d28131b0b117 · 2023-03-22T23:50:32.000Z
diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po
@@ -1074,6 +1074,15 @@ msgid ""
 "process management tool such as Supervisor - see `Running a logging socket "
 "listener in production`_ for more details."
 msgstr ""
+"`Gunicorn <https://gunicorn.org/>`_ や `uWSGI <https://uwsgi-docs."
+"readthedocs.io/en/latest/>`_ (またはそれに類するもの) を使って Web アプリケー"
+"ションをデプロイする場合、クライアントのリクエストを処理するために複数のワー"
+"カープロセスが作られます。そのような環境では、 web アプリケーションに直接ファ"
+"イルベースのハンドラを作ることは避けてください。 代わりに、 :class:"
+"`SocketHandler` を使って別のプロセスとして動作するリスナーに web アプリケー"
+"ションからログを送信するようにしてください。これは Supervisor のようなプロセ"
+"ス管理ツールを使うことで設定できます -  詳しくは `作成中のロギングソケットの"
+"リスナーを実行する`_ を参照してください。"
 
 #: ../../howto/logging-cookbook.rst:1536
 msgid "Using file rotation"
@@ -2239,7 +2248,7 @@ msgstr "当然のことですが、デコレーションはいつものやり方
 
 #: ../../howto/logging-cookbook.rst:2957
 msgid "Sending logging messages to email, with buffering"
-msgstr ""
+msgstr "バッファリングしながらロギングメッセージを email で送信する"
 
 #: ../../howto/logging-cookbook.rst:2959
 msgid ""
@@ -2251,6 +2260,13 @@ msgid ""
 "need to send things via SMTP. (Run the downloaded script with the ``-h`` "
 "argument to see the required and optional arguments.)"
 msgstr ""
+"ログメッセージをメールで、特に1つのメールにつき複数のログメッセージを、送信す"
+"る方法を例示するため、 :class:`~logging.handlers.BufferingHandler` を継承しま"
+"す。以下の例は、必要に応じて改変することもできますが、 SMTP 経由でログを送信"
+"するのに必要な情報をコマンドライン引数で指定してスクリプトを実行できるように"
+"簡単なテストハーネスも提供しています (必須の引数およびオプション引数の詳細を"
+"見るためには、ダウンロードしたスクリプトを ``-h`` 引数をつけて実行してくださ"
+"い)。"
 
 #: ../../howto/logging-cookbook.rst:3031
 msgid ""
@@ -2259,6 +2275,11 @@ msgid ""
 "emails will each have ten log messages, and the eleventh will have two "
 "messages. That makes up 102 messages as specified in the script."
 msgstr ""
+"SMTP サーバーを正しく設定した上でスクリプトを実行すると、指定したアドレス宛て"
+"に11通のメールを受け取るでしょう。最初の10通のメールはそれぞれ10個のログメッ"
+"セージを含み、11通目のメールは2つのログメッセージを含むはずです。これらのログ"
+"メッセージはスクリプト内で指定された102個のログメッセージから構成されていま"
+"す。"
 
 #: ../../howto/logging-cookbook.rst:3039
 msgid "Formatting times using UTC (GMT) via configuration"
@@ -2269,6 +2290,9 @@ msgid ""
 "Sometimes you want to format times using UTC, which can be done using a "
 "class such as ``UTCFormatter``, shown below::"
 msgstr ""
+"時刻を UTC でフォーマットしたい場合もあるでしょう。以下に示すように、そのよう"
+"なフォーマット処理は ``UTCFormatter`` のようなクラスを使って行うことができま"
+"す::"
 
 #: ../../howto/logging-cookbook.rst:3050
 msgid ""
@@ -2546,7 +2570,7 @@ msgstr ""
 
 #: ../../howto/logging-cookbook.rst:3608
 msgid "Logging to syslog with RFC5424 support"
-msgstr ""
+msgstr "RFC5424 をサポートする syslog へのロギング"
 
 #: ../../howto/logging-cookbook.rst:3610
 msgid ""
@@ -2557,13 +2581,23 @@ msgid ""
 "been widespread deployment of it in syslog servers, the :class:`~logging."
 "handlers.SysLogHandler` functionality has not been updated."
 msgstr ""
+":rfc:`5424` は 2009 年から始まっていますが、ほとんどの syslog サーバーはデ"
+"フォルトで、 2001 年から使われている古い :rfc:`3164` を使って構成されていま"
+"す。2003年に ``logging`` モジュールが Python に追加されたとき、モジュールは古"
+"い (そして当時唯一存在した) プロトコルをサポートしていました。 RFC5424 は、そ"
+"れが登場して以来、 syslog サーバーにおいて広く使われることがなかったため"
+"に、 :class:`~logging.handlers.SysLogHandler` の機能は更新されてきませんでし"
+"た。"
 
 #: ../../howto/logging-cookbook.rst:3617
 msgid ""
 "RFC 5424 contains some useful features such as support for structured data, "
 "and if you need to be able to log to a syslog server with support for it, "
 "you can do so with a subclassed handler which looks something like this::"
 msgstr ""
+"RFC 5424 は構造化データのサポートなど、いくつかの有用な機能を持っています。そ"
+"の機能をサポートする syslog サーバーへのロギングを可能にする必要がある場合、"
+"以下のような派生ハンドラクラスを使うことで実現することができます::"
 
 #: ../../howto/logging-cookbook.rst:3683
 msgid ""
@@ -2573,10 +2607,15 @@ msgid ""
 "your speciric needs. With the above handler, you'd pass structured data "
 "using something like this::"
 msgstr ""
+"上記のコードを完全に理解するには RFC 5424 を熟知する必要があります。また、上"
+"記の例とはやや異なる要求を持つこともあるでしょう (たとえば構造化データをログ"
+"に渡す方法について)。にもかかわらず、上記のコードは特有の要求に対する順応性が"
+"あります。上記のハンドラにより、構造化データは以下のように渡すことができるで"
+"しょう::"
 
 #: ../../howto/logging-cookbook.rst:3697
 msgid "How to treat a logger like an output stream"
-msgstr ""
+msgstr "ロガーを出力ストリームのように取り扱う方法"
 
 #: ../../howto/logging-cookbook.rst:3699
 msgid ""
@@ -2585,16 +2624,22 @@ msgid ""
 "logger. You can do this using a class which wraps a logger with a file-like "
 "API. Here's a short script illustrating such a class:"
 msgstr ""
+"書き込み先として file-like オブジェクトを期待するサードパーティの API に接続"
+"する必要がある一方で、その API の出力を直接ロガーに送りたいということがときど"
+"きあります。これは file-like な API でロガーをラップするクラスを使うことで実"
+"現できます。以下はそのようなクラスを例解する短いスクリプトです:"
 
 #: ../../howto/logging-cookbook.rst:3739
 msgid "When this script is run, it prints"
-msgstr ""
+msgstr "このスクリプトを実行すると、次のように出力されます。"
 
 #: ../../howto/logging-cookbook.rst:3746
 msgid ""
 "You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and ``sys."
 "stderr`` by doing something like this:"
 msgstr ""
+"また、 ``sys.stdout`` や ``sys.stderr`` をリダイレクトするには "
+"``LoggerWriter`` を使って以下のようにします:"
 
 #: ../../howto/logging-cookbook.rst:3756
 msgid ""
@@ -2603,6 +2648,10 @@ msgid ""
 "stderr`` value *before* it is overwritten by a ``LoggerWriter`` instance). "
 "Then, you'd get this kind of result:"
 msgstr ""
+"上記の操作は、必要に応じてロギングを設定した *後に* 行うべきです。上記の例で"
+"は、 :func:`~logging.basicConfig` の呼び出しが (``LoggerWriter`` インスタンス"
+"で上書きされる *前の* ``sys.stderr`` を使って) 設定を行います。そして、以下の"
+"ような結果を得るでしょう:"
 
 #: ../../howto/logging-cookbook.rst:3769
 msgid ""
