オプションで、 ローカル イベント ログの詳細度 を 1 ～ 4 の間で設定することにより、ローカル ログの詳細度を制御できます。すべてのイベントには 1 ～ 4 の範囲のレベルが関連付けられており、レベル 1 のイベントが最も重要とみなされます。

（注）	レベル 3 またはレベル 4 でのログ記録は、通常の操作では推奨されません。このような詳細なログ記録により、2 GB のログが急速に回転する可能性があるためです。 ただし、トラブルシューティングのためにこのレベルの詳細を記録する必要がある場合があります。

リモートログが有効かどうかに関係なく、イベントは常にローカルのイベントログに記録されます。

次の表は、さまざまなイベントに割り当てられたレベルの概要を示しています。

ログ レベルを変更すると、Web インターフェイスを通じて表示するイベント ログと、リモート ログ サーバにコピーされる情報の両方に影響します。 変更は遡及的ではなく、変更後に記録された内容にのみ影響します。

Expressway は、ローカル ログに次の機能を使用します。 (ローカル) ファシリティにマップされているソフトウェア コンポーネント/ログが強調表示されます。

• 0 (kern)

• 3（デーモン）

• 16 (local0) 管理者

• 17 (local1) Config

• 18 (local2) メディア統計

• 19 (local3) Apache エラー

• 20 (local4) etc/opt/apache2

• 21 (local5) 開発者

• 22 (local6) ネットワーク

イベントとレベル セクションには、Expressway によって記録されるすべてのイベントと、それらが記録されるレベルの完全なリストがあります。

環境によっては、Expressway ログがセキュリティ認定の要件に準拠していることを確認する必要がある場合があります。 セキュリティと診断用ログの目的の間にはトレードオフがあり、認証準拠モードでは問題の呼び出しの正確な原因を特定できない可能性があります。

Syslog は、複数のシステムからのログ メッセージを 1 つの場所に集約する便利な方法です。 これは、クラスター内のピアに特に推奨されます。

• 最大 4 台のリモート Syslog サーバーにログ メッセージを送信するように Expressway を設定できます。

• Syslog サーバは、次のいずれかの標準プロトコルをサポートする必要があります。

  • BSD（ RFC 3164で定義）

  • IETF（ RFC 5424で定義）

この表は、CDR に表示されるプロパティを定義します。

* 通話がセットアップされると、これらのエントリのうち 1 つだけがゼロ以外の値を持ちます (つまり、応答されたフォークまたはブランチのみ)。

CDR を収集するには、次の安全な REST API を使用できます。

• get_all_records (最大 7 日間のすべてのレコードを返します)。

• get_records_for_interval (指定された期間内のレコードを返します)。

• get_records_for_filter (任意の組み合わせを使用して結果をフィルタリングします)。

• get_all_csv_records (最大 7 日間のすべてのレコードを csv 形式で返します)。

重要	通話履歴はローカルに 7 日間のみ保存され、自動的に削除されます。

目的の API にアクセスするには、次の URL を使用します。

https://%3CExpressway_IP%3E/api/external/callusage/%3CAPI%3E

API の例

• http://%3CExpressway_IP%3E/api/external/callusage/get_all_records

• http://<Expressway_IP>/api/external/callusage/
  get_records_for_interval?fromtime=<fromtime>&totime=<to_time>

  例

  https://203.0.113.17/api/external/callusage/
  get_records_for_interval?fromtime=2014-05-09 2000:00:00&totime=
  2014-05-10 2000:00:00

入力パラメータ

• http://<Expressway_IP>/api/external/callusage/
  get_records_for_interval?fromtime=<fromtime>&totime=<to_time>

  例

  https://203.0.113.17/api/external/callusage/
  get_records_for_interval?fromtime=2014-05-09 2000:00:00&totime=
  2014-05-10 2000:00:00

• http://<Expressway_IP>/api/external/callusage/
  get_records_for_filter?uuid=<uuid>&src_alias=<src_alias>
  &dest_alias=<dest_alias>&protocol=<protocol>

  例

  https://203.0.113.17/api/external/callusage/
  get_records_for_filter?uuid=6e3b5a8a-346c-421b-aa2e-f4409c43a81a
  &src_alias=TC149-057-h323@domain.com&dest_alias=
  TC149-065-h323@domain.com&protocol=H323 <-> H323

  入力パラメータ

  パラメータ	説明
  uuid	レコードの一意の識別子。
  src_alias	通話の発信元。
  dest_ alias	通話の宛先ポイント。
  プロトコル	通話に使用されたプロトコル (SIP、H323 など)。

• http://%3CExpressway_IP%3E/api/external/callusage/get_all_csv_records

サンプル CDR

このサンプル CDR は、csv を除くすべての API に適用されます。

[{"initial_call": "false", "protocol": "SIP <-> SIP", "protocol_summary": "", "disconnect_reason": "200 OK", "licensed": "false", "tag": "b8d52a60-16a1-4bdb-be93-f5a675408811", "aside_request_uri": "", "box_call_serial_number": "22cd0e7d-c498-4068-9239-624038fe5130", "source_alias": "sip:10000005@10.196.4.82", "uuid": "800fe013-83f4-4094-a5e6-e2f9489912e2", "last_updated_timestamp": 1444725389, "details": "{\"Call\":{\"SerialNumber\": \"800fe013-83f4-4094-a5e6-e2f9489912e2\",\"BoxSerialNumber\": \"22cd0e7d-c498-4068-9239-624038fe5130\",\"Tag\": \"b8d52a60-16a1-4bdb-be93-f5a675408811\",\"State\": \"Disconnected\",\"StartTime\": \"2015-10-13 01:36:26.485636\",\"InitialCall\": \"False\",\"Licensed\": \"False\",\"LicensedAsTraversal\": \"False\",\"SourceAlias\": \"sip:10000005@10.196.4.82\",\"DestinationAlias\": \"sip:10000010@cucm-82\",\"ToLocalB2BUA\": \"False\",\"Audio\": \"False\",\"License\":{\"Traversal\": \"0\",\"NonTraversal\": \"0\",\"DemotedTraversal\": \"0\",\"CollaborationEdge\": \"0\",\"Cloud\": \"0\"},\"Duration\": \"3\",\"Legs\":[{\"Leg\":{\"Protocol\": \"SIP\",\"SIP\":{\"Address\": \"10.196.4.61:5073\",\"Transport\": \"TLS\",\"Aliases\":[{\"Alias\":{\"Type\": \"Url\",\"Origin\": \"Unknown\",\"Value\": \"sip:10000005@10.196.4.82\"}}]},\"Targets\":[{\"Target\":{\"Type\": \"Url\",\"Origin\": \"Unknown\",\"Value\": \"sip:10000010@10.196.4.116\"}}],\"BandwidthNode\": \"DefaultZone\",\"EncryptionType\": \"AES\",\"Cause\": \"200\",\"Reason\": \"OK\"}},{\"Leg\":{\"Protocol\": \"SIP\",\"SIP\":{\"Address\": \"10.196.4.71:7001\",\"Transport\": \"TLS\",\"Aliases\":[{\"Alias\":{\"Type\": \"Url\",\"Origin\": \"Unknown\",\"Value\": \"sip:10000010@cucm-82\"}}]},\"Source\":{\"Aliases\":[{\"Alias\":{\"Type\": \"Url\",\"Origin\": \"Unknown\",\"Value\": \"10000005@10.196.4.82\"}}]},\"BandwidthNode\": \"Traversal-zone\",\"EncryptionType\": \"AES\",\"Cause\": \"200\",\"Reason\": \"OK\"}}],\"Sessions\":[{\"Session\":{\"Status\": \"Completed\",\"MediaRouted\": \"False\",\"CallRouted\": \"True\",\"Participants\":{\"Leg\": \"1\",\"Leg\": \"2\",\"Incoming\":{\"Leg\": \"1\"},\"Outgoing\":{\"Leg\": \"2\"}}}}],\"EndTime\": \"2015-10-13 01:36:29.745651\"}}", "status": "Disconnected", "destination_alias": "sip:10000010@cucm-82", "licensed_as_traversal": "false", "service_uuid": "e6723fd0-5ca2-11e1-b86c-0800200c9a66", "start_time": "2015-10-13 01:36:26.485636", "traversal_license_tokens": 0, "bside_destination_alias": "", "active": "false", "media_routed": "false", "aside_destination_alias": "", "non_traversal_license_tokens": 0, "bside_request_uri": "", "end_time": "2015-10-13 01:36:29.745651", "audio": "false”}]

サンプル csv CDR

uuid,service_uuid,active,initial_call,licensed,licensed_as_traversal,
status,tag,box_call_serial_number,start_time,end_time,source_alias,
destination_alias,aside_destination_alias,bside_destination_alias,
aside_request_uri,bside_request_uri,protocol_summary,protocol,
media_routed,audio,traversal_license_tokens,non_traversal_license_tokens,
disconnect_reason,details,last_updated_timestamp

800fe013-83f4-4094-a5e6-e2f9489912e2,e6723fd0-5ca2-11e1-
b86c-0800200c9a66,false,false,false,false,Disconnected,b8d52a60-16a1-
4bdb-be93-f5a675408811,22cd0e7d-c498-4068-9239-624038fe5130,2015-10-
13 01:36:26.485636,2015-10-13

01:36:26.485636,2015-10-13 01:36:29.745651,sip:10000005@10.196.4.82,sip:10000010@cucm-82,,,,,,SIP <-> SIP,false,false,0,0,200 OK,"{""Call"":{""SerialNumber"": ""800fe013-83f4-4094-a5e6-e2f9489912e2"",""BoxSerialNumber"": ""22cd0e7d-c498-4068-9239-624038fe5130"",""Tag"": ""b8d52a60-16a1-4bdb-be93-f5a675408811"",""State"": ""Disconnected"",""StartTime"": ""2015-10-13 01:36:26.485636"",""InitialCall"": ""False"",""Licensed"": ""False"",""LicensedAsTraversal"": ""False"",""SourceAlias"": ""sip:10000005@10.196.4.82"",""DestinationAlias"": ""sip:10000010@cucm-82"",""ToLocalB2BUA"": ""False"",""Audio"": ""False"",""License"":{""Traversal"": ""0"",""NonTraversal"": ""0"",""DemotedTraversal"": ""0"",""CollaborationEdge"": ""0"",""Cloud"": ""0""},""Duration"": ""3"",""Legs"":[{""Leg"":{""Protocol"": ""SIP"",""SIP"":{""Address"": ""10.196.4.61:5073"",""Transport"": ""TLS"",""Aliases"":[{""Alias"":{""Type"": ""Url"",""Origin"": ""Unknown"",""Value"": ""sip:10000005@10.196.4.82""}}]},""Targets"":[{""Target"":{""Type"": ""Url"",""Origin"": ""Unknown"",""Value"": ""sip:10000010@10.196.4.116""}}],""BandwidthNode"": ""DefaultZone"",""EncryptionType"": ""AES"",""Cause"": ""200"",""Reason"": ""OK""}},{""Leg"":{""Protocol"": ""SIP"",""SIP"":{""Address"": ""10.196.4.71:7001"",""Transport"": ""TLS"",""Aliases"":[{""Alias"":{""Type"": ""Url"",""Origin"": ""Unknown"",""Value"": ""sip:10000010@cucm-82""}}]},""Source"":{""Aliases"":[{""Alias"":{""Type"": ""Url"",""Origin"": ""Unknown"",""Value"": ""10000005@10.196.4.82""}}]},""BandwidthNode"": ""Traversal-zone"",""EncryptionType"": ""AES"",""Cause"": ""200"",""Reason"": ""OK""}}],""Sessions"":[{""Session"":{""Status"": ""Completed"",""MediaRouted"": ""False"",""CallRouted"": ""True"",""Participants"":{""Leg"": ""1"",""Leg"": ""2"",""Incoming"":{""Leg"": ""1""},""Outgoing"":{""Leg"": ""2""}}}}],""EndTime"": ""2015-10-13 01:36:29.745651""}}",1444725389

• 電子メールを送信するための接続を確立するには、SMTP サーバの詳細を提供する必要があります。

• Expressway は、SMTP サーバとの TLS 接続のみをサポートします。

• SMTP サーバは、Expressway から直接または SMTP プロキシを使用してアクセスできる必要があります。 SMTP に HTTP プロキシを使用することはサポートされていません。

• メールを送信する前に、送信元の電子メールとパスワードが SMTP サーバで検証されます。

• X12.7 以降、Expressway では SMTP サービスが TLS 1.2 証明書ベースの検証を使用する必要があります。

  • クライアントが SMTP サーバ証明書を検証する際、その IP アドレスおよび/または完全修飾ドメイン名 (FQDN) が証明書の共通名 (CN)/サブジェクト別名 (SAN) に含まれている必要があります。

  • SMTP サーバ証明書の発行元を、Expressway の信頼できる証明機関 (CA) 証明書リスト (メンテナンス > セキュリティ > 信頼できる CA 証明書) にインポートする必要があります。

この改善の目的は、何らかの理由で複数のアラームが短期間に発生した場合に、管理者にメールをスパム送信しないようにすることです。

X14.2 以降、1 時間以内に同じアラームが 2 回以上発生した場合、電子メールは 1 回だけ送信されます。 同じアラームが解除されてから再度発生した場合、経過時間に関係なく、メールが送信されます。 当然、これは管理者がデバイスでメール通知を受信するように構成している場合にのみ適用されます。

（注）	過去 1 時間以内に特定のアラームに関する電子メールがすでに送信されている場合、システムは電子メール通知を繰り返し送信してはなりません。

ここにいくつかの例を示します。

1. 例 1

   1. ID 15000 のアラームが 14:00 に発生します。

   2. 電子メール通知が設定され、ID 15000 のアラームに対して電子メールが送信されます。

   3. 同じアラーム (ID 15000) が 14:55 に発生しましたが、1 時間経過していないため電子メール通知は送信されません。 ただし、15:01 に同じアラームが発生した場合は、電子メール通知が送信されます。

2. 例 2

   1. ID 15000 のアラームが 14:00 に発生します。

   2. 電子メール通知が設定され、ID 15000 のアラームに対して電子メールが送信されます。

   3. 14:05 に同じ警報が解除されます。

   4. ID 15000 のアラームが 14:10 に再度発生します。

   5. ID 15000 のアラームの電子メール通知が再度送信されます。

次のハードウェア統計が監視されます。

• aggregation-cpu-sum

• aggregation-cpu-average

• システム内の各コアのコアあたりの CPU 使用率

• df

• ディスク

• load

• protocols-Tcp

• protocols-Udp

• スワップ

• ユーザ（Users）

• メモリ

• アップタイム（Uptime）

• プロセス

次のアプリケーション データは、collectd のカスタム exec-app プラグインによって監視されます。

• gauge-active_alarms は、この Expressway 上のアクティブなアラームの数です。

• gauge-active_calls は、この Expressway で処理されている通話の数です。

• gauge-<service name> は各システムサービスのステータスです。

• gauge-<zone name>_ActiveCalls は、指定されたゾーン内のアクティブな通話をカウントします。

• ゲージ-<zone name>_BandwidthAllocated は、指定されたゾーンに割り当てられた合計帯域幅を測定します。

• gauge-<zone name>_BandwidthLimit

これらの各メトリックは、自由形式のデータを許可する collectd GAUGE データ ソース タイプを使用します。 収集サーバーでは、完全な collectd 値の名前が表示されます、例: collectdHostnamecollectd.exec-app.gauge-active_calls。

（注）	ゾーン名はユーザーが設定できるため、collectd メトリックの命名スキーマと競合する可能性があります。 収集サーバがスキーマを適用している場合、一部のゾーンからのメトリックが受け入れられない可能性があります。

収集サーバに送信されるデータ

ネットワーク プラグインは、 collectd バイナリ プロトコル を使用して、監視対象のハードウェア リソースとソフトウェア プロセスを表す数値、文字列、および値のデータをカプセル化します。 プラグインは、デフォルトで UDP 25826 を使用して、間隔ごとに 1 回メトリック データ パケットを分析サーバにプッシュします。 分析サーバはデータを解析し、人間が読める形式で提示します。

分析サーバが collectd ネットワーク プラグインと csv プラグインを使用している場合、メトリックはメトリック名とタイムスタンプを使用してファイル名が作成され、小さな CSV ファイルとして保存されます。 例えば、 gauge-H323-2015-05-21

collectd プラグイン

これらの collectd プラグインは Expressway に実装されています。