21.4. アクセスログ統計の取得
logconv.pl スクリプトはアクセスログを解析し、サーバーで実行するさまざまなユーザーおよび操作に関するサマリー情報を返します。
最も簡単な方法は、スクリプトはアクセスログ (単数または複数) を解析するだけです。
# logconv.pl /relative/path/to/accessLog
このスクリプトはワイルドカードを受け入れて複数のアクセスログを解析できます。これはログローテーションが使用される場合に役立ちます。
# logconv.pl /var/log/dirsrv/slapd-instance/access*
logconv.pl のさまざまなオプションは、man ページと 『設定、コマンド、およびファイルリファレンス』 で説明されています。
logconv.pl は、アクセスログから一般的な使用状況を引き出すために、いくつかの異なる方法があります。
最も簡単な方法としては、
logconv.pl が、総操作数、総接続数、各操作タイプごとのカウント、永続的な検索などの拡張操作のカウント、およびバインド情報のリストを表示します。
# logconv.pl /var/log/dirsrv/slapd-instance/access
Access Log Analyzer 8.2
Command: logconv.pl /var/log/dirsrv/slapd-instance/access
Processing 1 Access Log(s)...
[001] /var/log/dirsrv/slapd-instance/access size (bytes): 77532
Total Log Lines Analysed: 527
Start of Logs: 14/Oct/2017:16:15:22.452909568
End of Logs: 14/Oct/2017:16:39:50.157790196
Processed Log Time: 0 Hours, 24 Minutes, 27.704877056 Seconds
Restarts: 10
Secure Protocol Versions:
- TLS1.2 client bound as uid=user_name,ou=people,o=example.com (11 connections)
- TLS1.2 128-bit AES; client CN=CA Subsystem,O=example.com; issuer CN=Certificate Authority,O=example.com (11 connections)
- TLS1.2 128-bit AES-GCM (2 connections)
- TLS1.2 128-bit AES (3 connections)
Peak Concurrent Connections: 38
Total Operations: 4771
Total Results: 4653
Overall Performance: 97.5%
Total Connections: 249 (0.17/sec) (10.18/min)
- LDAP Connections: 107 (0.07/sec) (4.37/min)
- LDAPI Connections: 128 (0.09/sec) (5.23/min)
- LDAPS Connections: 14 (0.01/sec) (0.57/min)
- StartTLS Extended Ops: 2 (0.00/sec) (0.08/min)
Searches: 2963 (2.02/sec) (121.13/min)
Modifications: 649 (0.44/sec) (26.53/min)
Adds: 785 (0.53/sec) (32.09/min)
Deletes: 10 (0.01/sec) (0.41/min)
Mod RDNs: 6 (0.00/sec) (0.25/min)
Compares: 0 (0.00/sec) (0.00/min)
Binds: 324 (0.22/sec) (13.25/min)
Proxied Auth Operations: 0
Persistent Searches: 17
Internal Operations: 0
Entry Operations: 0
Extended Operations: 4
Abandoned Requests: 0
Smart Referrals Received: 0
VLV Operations: 30
VLV Unindexed Searches: 0
VLV Unindexed Components: 20
SORT Operations: 22
Entire Search Base Queries: 12
Paged Searches: 2
Unindexed Searches: 0
Unindexed Components: 149
FDs Taken: 249
FDs Returned: 212
Highest FD Taken: 107
Broken Pipes: 0
Connections Reset By Peer: 0
Resource Unavailable: 0
Max BER Size Exceeded: 0
Binds: 324
Unbinds: 155
---------------------------------
- LDAP v2 Binds: 41
- LDAP v3 Binds: 180
- AUTOBINDs(LDAPI): 103
- SSL Client Binds: 0
- Failed SSL Client Binds: 0
- SASL Binds: 134
- EXTERNAL: 114
- GSSAPI: 20
- Directory Manager Binds: 10
- Anonymous Binds: 1
Cleaning up temp files...
Done.
操作と接続のサマリー情報に加えて、サーバーへのすべての接続のより詳細なサマリー情報を提供します。この情報には、サーバーへの接続に使用された最も一般的な IP アドレス、ログインに最も失敗した DN、サーバーへのアクセスに使用された合計バインド DN 数、最も一般的なエラーコードやリターンコードなどが含まれます。
その他の接続サマリーは単一オプションとして渡されます。たとえば、サーバー (
b) への接続に使用する DN 数と、サーバーによって返された合計接続コード (c) を -bc として渡します。
# logconv.pl -bc /var/log/dirsrv/slapd-instance/access
...
----- Total Connection Codes -----
U1 3 Cleanly Closed Connections
B1 1 Bad Ber Tag Encountered
----- Top 20 Bind DN's -----
Number of Unique Bind DN's: 212
1801 cn=Directory Manager
1297 Anonymous Binds
311 uid=jsmith,ou=people...
87 uid=bjensen,ou=peopl...
85 uid=mreynolds,ou=peo...
69 uid=jrockford,ou=peo...
55 uid=sspencer,ou=peop...
...
データは、特定の開始時間 (
-S) 以降、特定の終了時間 (-E) 以降、または範囲内からエントリーに制限することができます。開始時間と終了時間が設定されると、logconv.pl が最初に指定の時間範囲を出力し、次にその期間の概要を出力します。
# logconv.pl -S "[01/Jul/2016:16:11:47.000000000 -0400]" -E "[01/Jul/2016:17:23:08.999999999 -0400]" /var/log/dirsrv/slapd-instance/access
...
----------- Access Log Output ------------
Start of Logs: 01/Jul/2016:16:11:47
End of Logs: 01/Jul/2016:17:23:08
...
開始時間と終了の期間は、合計サマリー数の生成に使用されるデータの時間制限のみを設定します。それでも、集計または合計の数が表示されます。Directory Server への接続や操作のパターンを把握するために、1 分ごと (
-M) や 1 秒ごと (-m) のカウントデータを出力することができます。この場合、データは時間単位で、指定した CSV 出力ファイルに出力されます。
# logconv.pl -m|-M outputFile accessLogFile
以下に例を示します。
# logconv.pl -M /home/output/statsPerMin.txt /var/log/dirsrv/slapd-instance/access*
-M|-m オプションは、-S 引数および -E 引数と共に使用することで、特定の期間内の分単位または秒単位のカウントを取得することもできます。
ファイルの各行は、分または秒の 1 つの時間単位を表し、その期間の合計数を示しています。CSV ファイル (1 分ごとの統計および 1 秒ごと統計の両方) には、以下のコラムが順番に含まれます。
Time,time_t,Results,Search,Add,Mod,Modrdn,Delete,Abandon,Connections,SSL Conns,Bind,Anon Bind,Unbind,Unindexed
CSV ファイルは、LibreOffice Calc などのスプレッドシートプログラムや、その他多くのビジネスアプリケーションで操作できます。CSV データをインポートし、チャートまたは他のメトリックを生成する手順は、アプリケーション自体によって異なります。
たとえば、LibreOffice Calc でチャートを作成するには、次のコマンドを実行します。
- CSV ファイルを開きます。
- メニューをクリックし、 を選択します。
- Chart Type エリアで、チャートタイプを XY (Scatter) に設定します。
- サブタイプを行のみに設定します。
- X 値でソートするオプションを選択します。
- 他の画面のデフォルト (特に、データ系列を列で使用すること、最初の行と最初の列をラベルとして設定すること) を受け入れて、チャートを作成します。