@@ -1074,6 +1074,15 @@ msgid ""
10741074"process management tool such as Supervisor - see `Running a logging socket "
10751075"listener in production`_ for more details."
10761076msgstr ""
1077+ "`Gunicorn <https://gunicorn.org/>`_ や `uWSGI <https://uwsgi-docs."
1078+ "readthedocs.io/en/latest/>`_ (またはそれに類するもの) を使って Web アプリケー"
1079+ "ションをデプロイする場合、クライアントのリクエストを処理するために複数のワー"
1080+ "カープロセスが作られます。そのような環境では、 web アプリケーションに直接ファ"
1081+ "イルベースのハンドラを作ることは避けてください。 代わりに、 :class:"
1082+ "`SocketHandler` を使って別のプロセスとして動作するリスナーに web アプリケー"
1083+ "ションからログを送信するようにしてください。これは Supervisor のようなプロセ"
1084+ "ス管理ツールを使うことで設定できます - 詳しくは `作成中のロギングソケットの"
1085+ "リスナーを実行する`_ を参照してください。"
10771086
10781087#: ../../howto/logging-cookbook.rst:1536
10791088msgid "Using file rotation"
@@ -2239,7 +2248,7 @@ msgstr "当然のことですが、デコレーションはいつものやり方
22392248
22402249#: ../../howto/logging-cookbook.rst:2957
22412250msgid "Sending logging messages to email, with buffering"
2242- msgstr ""
2251+ msgstr "バッファリングしながらロギングメッセージを email で送信する "
22432252
22442253#: ../../howto/logging-cookbook.rst:2959
22452254msgid ""
@@ -2251,6 +2260,13 @@ msgid ""
22512260"need to send things via SMTP. (Run the downloaded script with the ``-h`` "
22522261"argument to see the required and optional arguments.)"
22532262msgstr ""
2263+ "ログメッセージをメールで、特に1つのメールにつき複数のログメッセージを、送信す"
2264+ "る方法を例示するため、 :class:`~logging.handlers.BufferingHandler` を継承しま"
2265+ "す。以下の例は、必要に応じて改変することもできますが、 SMTP 経由でログを送信"
2266+ "するのに必要な情報をコマンドライン引数で指定してスクリプトを実行できるように"
2267+ "簡単なテストハーネスも提供しています (必須の引数およびオプション引数の詳細を"
2268+ "見るためには、ダウンロードしたスクリプトを ``-h`` 引数をつけて実行してくださ"
2269+ "い)。"
22542270
22552271#: ../../howto/logging-cookbook.rst:3031
22562272msgid ""
@@ -2259,6 +2275,11 @@ msgid ""
22592275"emails will each have ten log messages, and the eleventh will have two "
22602276"messages. That makes up 102 messages as specified in the script."
22612277msgstr ""
2278+ "SMTP サーバーを正しく設定した上でスクリプトを実行すると、指定したアドレス宛て"
2279+ "に11通のメールを受け取るでしょう。最初の10通のメールはそれぞれ10個のログメッ"
2280+ "セージを含み、11通目のメールは2つのログメッセージを含むはずです。これらのログ"
2281+ "メッセージはスクリプト内で指定された102個のログメッセージから構成されていま"
2282+ "す。"
22622283
22632284#: ../../howto/logging-cookbook.rst:3039
22642285msgid "Formatting times using UTC (GMT) via configuration"
@@ -2269,6 +2290,9 @@ msgid ""
22692290"Sometimes you want to format times using UTC, which can be done using a "
22702291"class such as ``UTCFormatter``, shown below::"
22712292msgstr ""
2293+ "時刻を UTC でフォーマットしたい場合もあるでしょう。以下に示すように、そのよう"
2294+ "なフォーマット処理は ``UTCFormatter`` のようなクラスを使って行うことができま"
2295+ "す::"
22722296
22732297#: ../../howto/logging-cookbook.rst:3050
22742298msgid ""
@@ -2546,7 +2570,7 @@ msgstr ""
25462570
25472571#: ../../howto/logging-cookbook.rst:3608
25482572msgid "Logging to syslog with RFC5424 support"
2549- msgstr ""
2573+ msgstr "RFC5424 をサポートする syslog へのロギング "
25502574
25512575#: ../../howto/logging-cookbook.rst:3610
25522576msgid ""
@@ -2557,13 +2581,23 @@ msgid ""
25572581"been widespread deployment of it in syslog servers, the :class:`~logging."
25582582"handlers.SysLogHandler` functionality has not been updated."
25592583msgstr ""
2584+ ":rfc:`5424` は 2009 年から始まっていますが、ほとんどの syslog サーバーはデ"
2585+ "フォルトで、 2001 年から使われている古い :rfc:`3164` を使って構成されていま"
2586+ "す。2003年に ``logging`` モジュールが Python に追加されたとき、モジュールは古"
2587+ "い (そして当時唯一存在した) プロトコルをサポートしていました。 RFC5424 は、そ"
2588+ "れが登場して以来、 syslog サーバーにおいて広く使われることがなかったため"
2589+ "に、 :class:`~logging.handlers.SysLogHandler` の機能は更新されてきませんでし"
2590+ "た。"
25602591
25612592#: ../../howto/logging-cookbook.rst:3617
25622593msgid ""
25632594"RFC 5424 contains some useful features such as support for structured data, "
25642595"and if you need to be able to log to a syslog server with support for it, "
25652596"you can do so with a subclassed handler which looks something like this::"
25662597msgstr ""
2598+ "RFC 5424 は構造化データのサポートなど、いくつかの有用な機能を持っています。そ"
2599+ "の機能をサポートする syslog サーバーへのロギングを可能にする必要がある場合、"
2600+ "以下のような派生ハンドラクラスを使うことで実現することができます::"
25672601
25682602#: ../../howto/logging-cookbook.rst:3683
25692603msgid ""
@@ -2573,10 +2607,15 @@ msgid ""
25732607"your speciric needs. With the above handler, you'd pass structured data "
25742608"using something like this::"
25752609msgstr ""
2610+ "上記のコードを完全に理解するには RFC 5424 を熟知する必要があります。また、上"
2611+ "記の例とはやや異なる要求を持つこともあるでしょう (たとえば構造化データをログ"
2612+ "に渡す方法について)。にもかかわらず、上記のコードは特有の要求に対する順応性が"
2613+ "あります。上記のハンドラにより、構造化データは以下のように渡すことができるで"
2614+ "しょう::"
25762615
25772616#: ../../howto/logging-cookbook.rst:3697
25782617msgid "How to treat a logger like an output stream"
2579- msgstr ""
2618+ msgstr "ロガーを出力ストリームのように取り扱う方法 "
25802619
25812620#: ../../howto/logging-cookbook.rst:3699
25822621msgid ""
@@ -2585,16 +2624,22 @@ msgid ""
25852624"logger. You can do this using a class which wraps a logger with a file-like "
25862625"API. Here's a short script illustrating such a class:"
25872626msgstr ""
2627+ "書き込み先として file-like オブジェクトを期待するサードパーティの API に接続"
2628+ "する必要がある一方で、その API の出力を直接ロガーに送りたいということがときど"
2629+ "きあります。これは file-like な API でロガーをラップするクラスを使うことで実"
2630+ "現できます。以下はそのようなクラスを例解する短いスクリプトです:"
25882631
25892632#: ../../howto/logging-cookbook.rst:3739
25902633msgid "When this script is run, it prints"
2591- msgstr ""
2634+ msgstr "このスクリプトを実行すると、次のように出力されます。 "
25922635
25932636#: ../../howto/logging-cookbook.rst:3746
25942637msgid ""
25952638"You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and ``sys."
25962639"stderr`` by doing something like this:"
25972640msgstr ""
2641+ "また、 ``sys.stdout`` や ``sys.stderr`` をリダイレクトするには "
2642+ "``LoggerWriter`` を使って以下のようにします:"
25982643
25992644#: ../../howto/logging-cookbook.rst:3756
26002645msgid ""
@@ -2603,6 +2648,10 @@ msgid ""
26032648"stderr`` value *before* it is overwritten by a ``LoggerWriter`` instance). "
26042649"Then, you'd get this kind of result:"
26052650msgstr ""
2651+ "上記の操作は、必要に応じてロギングを設定した *後に* 行うべきです。上記の例で"
2652+ "は、 :func:`~logging.basicConfig` の呼び出しが (``LoggerWriter`` インスタンス"
2653+ "で上書きされる *前の* ``sys.stderr`` を使って) 設定を行います。そして、以下の"
2654+ "ような結果を得るでしょう:"
26062655
26072656#: ../../howto/logging-cookbook.rst:3769
26082657msgid ""
