# 12. その他のセクション
> トレース、ユーザー、メール送信先、エラー、リング、証明書、ACME、グローバルヘルスチェック
---
LLMSインデックス: [llms.txt](/ja/llms.txt)
---
以下のセクションは使用頻度が低く、通常は少数のパラメーターだけをサポートします。セクション同士に暗黙の関係はありません。いずれも単一のキーワードで開始します。"global"セクションより前に置くことはできません。SSL関連など、一部のサポートはビルドオプションによる場合があります。
## 12.1. トレース {#section-12-1}
デバッグのために、HAProxyのサブシステムでトレースを有効にできます。特定のサブシステムのデバッグメッセージを出力する、問題の診断に非常に有効なツールです。トレースはCLIで動的に設定できます。また、専用の"traces"セクションで、一部の設定を設定ファイルにあらかじめ定義できます。詳しくは管理ガイドを参照してください。あくまで複雑なデバッグ作業で使う開発者向けツールです。出力が多く、負荷もあるため、慎重に使ってください。開発者向けツールであるため、このセクションの後方互換性は保証しません。
**`traces`**
```haproxy
traces
```
新しいtracesセクションを開始します。"traces"セクションは一つでも複数でも構いません。すべてのディレクティブを宣言順に評価し、後の指定が前の指定を上書きします。
**`trace `**
```haproxy
trace
```
"trace"サブシステムを設定します。それぞれを管理マニュアルで説明しており、構文もまったく同じです。"trace"コマンドが生成する出力は、このセクションの解析時に出力します。通常はエラーや警告ですが、一部の不完全なコマンドは、指定可能な選択肢を一覧表示する場合があります。このコマンドは通常の利用を想定しておらず、一般には、複雑なデバッグ作業中に開発者が使用を勧めます。トレースレベルや詳細度によっては、有効化により全体の性能が大幅に低下することを覚えておいてください。文の構文は管理マニュアルを参照してください。
例：
```text
ring buf1
size 10485760 # 10MB
format timed
backing-file /tmp/h1.traces
ring buf2
size 10485760 # 10MB
format timed
backing-file /tmp/h2.traces
traces
trace h1 sink buf1 level developer verbosity complete start now
trace h2 sink buf1 level developer verbosity complete start now
```
## 12.2. ユーザー一覧 {#section-12-2}
認証と認可を受けたユーザーだけを許可することで、frontend/backend/listenセクションやhttp統計へのアクセスを制御できます。そのためには、少なくとも一つのuserlistを作成し、ユーザーを定義する必要があります。
**`userlist `**
```haproxy
userlist
```
``という名前の新しいuserlistを作成します。独立した顧客の認証・認可データを保存するため、複数の独立したuserlistを使えます。
**`group [users ,,(...)]`**
```haproxy
group [users ,,(...)]
```
現在のuserlistにグループ``を追加します。"users"キーワードに続けて、名前をカンマで区切った一覧を指定すると、このグループにユーザーを所属させることもできます。
**`user [password|insecure-password ]`**
```haproxy
user [password|insecure-password ]
[groups ,,(...)]
```
現在のuserlistにユーザー``を追加します。安全な（暗号化された）パスワードと、安全でない（暗号化されていない）パスワードの両方を使えます。暗号化パスワードはcrypt(3)関数で評価するため、システムの機能に応じて対応アルゴリズムが異なります。たとえば、現在のGlibcベースのLinuxは、MD5、SHA-256、SHA-512に加えて、従来のDESによるパスワード暗号化方式もサポートします。
注意：暗号化パスワードを使うと、リクエスト数とアルゴリズムによってはCPU使用率が大幅に増えることがあります。ハッシュを使う方式では、各リクエストのパスワードを、設定ファイルの値と比較する前に、選択したアルゴリズムで処理しなければなりません。現在のほとんどのアルゴリズムは、総当たり攻撃に耐えるため、意図的に計算コストを高くしています。平文パスワードにソルトを付けて一度ハッシュするだけでなく、何千回も繰り返します。これはすぐにHAProxy全体のCPU消費の大きな要因となり、アプリケーションのクラッシュを招くことさえあります。
ハッシュ関数の高いCPU使用率への対処方法として、ハッシュ関数のラウンド数（SHA系アルゴリズム）を減らすか、対応するアルゴリズムなら関数の"cost"を下げる方法があります。
補足として、musl（Alpine Linuxなど）の実装は、ハッシュ計算でglibcの実装より遅いことが知られているため、この点も考慮するとよいでしょう。
すべてのパスワードは通常の引数として扱うため、[セクション2.2](/ja/docs/haproxy/configuration-basics/#section-2-2)の引用とエスケープの規則が適用されます。したがって、パスワードを単一引用符で囲むことを推奨します。
例：
```text
userlist L1
group G1 users tiger,scott
group G2 users xdb,scott
user tiger password $6$k6y3o.eP$JlKBx9za9667qe4(...)xHSwRv6J.C0/D7cV91
user scott insecure-password 'elgato'
user xdb insecure-password 'hello'
userlist L2
group G1
group G2
user tiger password $6$k6y3o.eP$JlKBx(...)xHSwRv6J.C0/D7cV91 groups G1
user scott insecure-password 'elgato' groups G1,G2
user xdb insecure-password 'hello' groups G2
```
両方の一覧は、機能的に同じである点に注意してください。
## 12.3. メール送信先 {#section-12-3}
サーバーの状態が変わると、メールでアラートを送信できます。設定すると、mailersセクションで指定した各送信先へアラートを送ります。メールはLuaを通じて送信します（examples/lua/mailers.luaを参照）。
**`mailers `**
```haproxy
mailers
```
``という名前の新しいメール送信先一覧を作成します。一つ以上のプロキシから参照する、独立したセクションです。
**`mailer :`**
```haproxy
mailer :
```
mailersセクション内にメール送信先を定義します。
例：
```text
global
# mailers.lua file as provided in the git repository
# adjust path as needed
lua-load examples/lua/mailers.lua
mailers mymailers
mailer smtp1 192.168.0.1:587
mailer smtp2 192.168.0.2:587
backend mybackend
mode tcp
balance roundrobin
email-alert mailers mymailers
email-alert from test1@horms.org
email-alert to test2@horms.org
server srv1 192.168.0.30:80
server srv2 192.168.0.31:80
```
**`timeout mail