ログとエラー コード

QlikView Server からのすべてのアラートは、Windows のイベント ログに表示されます。

QlikView Server からのログ

詳細なセッション ログはログ ディレクトリにあり、これは QlikView Management Console (QMC) で [システム (System)] > [設定 (Setup)] の順でクリックし、[ログ (Logging)] タブで指定します。既定の場所は %ProgramData%\QlikTech\QlikViewServer です。

ログ ファイルの分割 (新規作成) を、毎日、毎週、毎月、毎年、なしに設定できます。パフォーマンス ログの間隔を 1 分もしくはそれ以上に設定できます。

注: ログ間隔を 1 分ごとのように小さい値で設定すると、パフォーマンスにマイナスの影響を与える場合があります。

セッション ログ

1 セッションの定義は、1 つのドキュメントに 1 人のユーザーが接続することです。

注: セッション ログは、セッションが終わる度に更新されます。これは、セッション開始時には、ログ エントリは作成されないことを意味します。

セッション ログのファイル名は、Sessions*.log で、* はサーバー名と分割する間隔を示します。セッション ログの各エントリには、次の項目が含まれます。

項目 説明
Exe Type

QVS ビルドの種類。

例: 'RLS64' = 64 ビット リリース ビルド

Exe Version

QVS のフル バージョン番号。

例: “11.00.11076.0409.10”

Server started QVS が開始された日付および時刻。
タイムスタンプ ログ エントリが作成された日付および時刻。
ドキュメント アクセスした QlikView ドキュメント。
Document Timestamp アクセスしたドキュメント ファイルのタイムスタンプ。
QlikView User QlikView セクション アクセス ユーザー ID (使用されている場合)
Exit Reason

セッションの終了理由。

  • 「Socket closed」 = クライアントによる終了
  • 「LRU」= 新規ユーザー優先で最も長い間使用されていないとして終了
  • 「Shutdown」= その他の理由からサーバーが終了
注: これは完全なリストではありません。オペレーション システムから返される終了値もあります。
Session Start セッションが開始された時間。
Session Duration セッションの長さ (時間: 分: 秒)
CPU Spent (s) セッションが使用した CPU 秒。
Bytes Received セッション中にサーバーが受信したバイト数。
Bytes Sent セッション中にサーバーが送信したバイト数。
Calls セッション中の QlikView コール数 (双方向)。
選択 セッション中に行われた QlikView の選択数。
Authenticated User 認証済み Windows NT® ユーザー ID (あれば)。
Identifying User クライアント ユーザー識別。
Client Machine Identification

クライアント マシン識別。

デフォルトでは、Windows Management Instrumentation(WMI) に対する呼び出しの、universally unique identifier (UUID) 受信者です。

UUIDが使用できない場合は、代わりに次の ID のいずれかが表示されます。

  • コンピュータの MAC address
  • コンピュータ名
  • ユニークなマシン ID (セッションで使用されたブラウザがプライベート モードであった場合)
Serial Number QlikView クライアントのシリアル番号 (QlikView Desktop および Internet Explorer プラグインがインストールされているクライアントのみ)。
Client Type

クライアントの種類:

  • 「Windows Exe」= QlikView Desktop および Internet Explorer プラグイン
  • 「Ajax」= QVPX プロトコルを使用しているすべてのクライアント
  • 「Unknown」
Client Build Version QlikView クライアントのビルド バージョン。
Secure Protocol

セキュア プロトコル:

  • 「On」は暗号化通信が使用された場合 (通常 Windows クライアント)。
  • 「Off」は暗号化通信が使用されなかった場合。
Tunnel Protocol 「Tunnel」は QVS トンネル通信が使用された場合。
Server Port サーバーに使用されたポート。
Client Address サーバーに接続 (上記「Server Port」項目で指定されたポートを使用) しているクライアントのクライアント IP 番号。
Client Port クライアント ポート。
Cal の種類

Client Access License (CAL) の種類:

  • 「User」= Named User CAL
  • 「Session」= Session CAL
  • 「Usage」= Usage CAL
  • 「Document」= Document CAL
Cal Usage Count Usage CAL の数。

パフォーマンス ログ

パフォーマンス ログは、QMC で [システム (System)] > [設定 (Setup)] の順でクリックし、[ログ (Logging)] タブで指定した間隔で更新されます。デフォルトの間隔は 5 分です。サーバーが開始あるいは停止した際には、追加のエントリが入力されます。ログのファイル名は、Performance*.log で、* はサーバー名と分割する間隔を示します。

ログの各エントリには、次の項目が含まれます。

項目 説明
Exe Type

QVS ビルドの種類。

例: 'RLS64' = 64 ビット リリース ビルド

Exe Version

QVS のフル バージョン番号。

例: “11.00.11076.0409.10”

Server started QVS が開始された日付および時刻。
タイムスタンプ ログ エントリが作成された日付および時刻。
EntryType

エントリの種類:

  • 「Server starting」= スタートアップ
  • 「Normal」= 通常のインターバルのログ エントリ
  • 「Server shutting down」= シャットダウン
ActiveDocSessions インターバルの間、そしてインターバルの終わりにまだ存在する活動を示すドキュメントのセッション* 数
DocSessions インターバルの終わりに存在するドキュメントのセッション* 合計数
ActiveAnonymousDocSessions インターバルの間、そしてインターバルの終わりにまだ存在する活動を示す匿名ユーザーのドキュメントのセッション* 数
AnonymousDocSessions インターバルの終わりに存在する匿名ユーザーのドキュメントのセッション* 合計数
ActiveTunneledDocSessions インターバルの間、そしてインターバルの終わりにまだ存在する活動を示すトンネル接続のドキュメントのセッション* 数
TunneledDocSessions インターバルの終わりに存在するトンネル接続のドキュメントのセッション* 合計数
DocSessionStarts インターバルの間に開始されたドキュメントのセッション* 数
ActiveDocs ユーザー アクティビティが存在していたインターバルの、終了時にロードされていたドキュメントの数。
RefDocs 終了時にセッションが存在しているインターバルの、終了時にロードされていたドキュメントの数。
LoadedDocs インターバルの終了時にロードされていた、ドキュメントの総数。
DocLoads インターバル中にロードされた、新規ドキュメントの数。
DocLoadFails インターバル中にロードに失敗した、ドキュメントの数。
Calls インターバル中に実行された、QVS に対するコールの総数。
選択 インターバル中に実行された、選択コールの数。
ActiveIpAddrs

インターバル中にアクティブになったことがあり、インターバルの終了時にもまだ存在していた、異なる IP アドレスの数。

注: 同一 IP アドレスに由来するトンネル セッションと複数のユーザーは、区別できないので注意が必要です。
IpAddrs

インターバルの終了時に接続されていた、異なる IP アドレスの総数。

注: 同一 IP アドレスに由来するトンネル セッションと複数のユーザーは、区別できないので注意が必要です。
ActiveUsers

インターバル中にアクティブになったことがあり、インターバルの終了時にもまだ存在していた、異なる NT ユーザーの数。

注: 匿名ユーザーは識別できないので注意が必要です。
Users

インターバルの終了時に接続されていた、異なる NT ユーザーの総数。

注: 匿名ユーザーは識別できないので注意が必要です。
CPULoad インターバル中の、QVS からの平均 CPU ロード。
VMAllocated(MB) インターバル** の終了時点における、QVS に割り当てられた仮想メモリのサイズ (MB)
VMCommitted(MB) インターバル** の終了時点における、QVS が実際に使用した仮想メモリのサイズ (MB)この数値は、VMAllocated(MB) の一部です。許容外の応答時間を回避するため、物理メモリのサイズを超過しないようにします。
VMFree(MB) QVS** で使用可能な割り当てられていない仮想メモリのサイズ (MB)
VMLargestFreeBlock(MB) QVS で使用可能な、割り当てられていない仮想メモリの最大連続ブロックのサイズ (MB)。この数値は VMFree(MB) の一部です。
UsageCalBalance 「-1.00」= Usage CAL はありません。

* 1 ユーザー + 1 ドキュメント = 1 ドキュメント セッション

**VMAllocated(MB) + VMFree(MB) = QVS プロセスに使用可能な合計最大仮想メモリ量。

イベント ログ

イベント ログは、QVS から Windows のイベント ログにログが書き込まれる度に更新されます。保存される情報は、Windows イベント ログに書き込まれた情報のコピーです。イベント ログのファイル名は Events*.log で、* はサーバー名と分割する間隔を示します。

QMC の [システム (System)] > [設定 (Setup)] > [QlikView Server] > [ログ (Logging)] タブにある [イベント ログ レベル (Event Log Verbosity)] ラジオ ボタンを使用して、レベルを設定します。選択されたレベルによって、イベント ログに以下の入力が書き込まれます。

  • : エラー メッセージ
  • : エラーおよび警告メッセージ
  • : エラー、警告および情報メッセージ

ログの各エントリには、次の項目が含まれます。

項目 説明
Server started QVS が開始された日付および時刻。
タイムスタンプ ログ エントリが作成された日付および時刻。
SeverityID

重要度レベルごとの ID:

  • 1 = エラー (Error)
  • 2 = 警告 (Warning)
  • 4 = 情報 (Information)
EventID イベントの種類ごとの一意の ID。
Severity イベントの重要度レベル:
  • エラー
  • 情報 (Information)
  • 警告 (Warning)
メッセージ イベントの説明。

エンドユーザーの監査ログ

エンドユーザーの監査ログには、選択のクリアやアクティブ化されたシート、ブックマークの適用、アクセスのあったレポート、最大化されたオブジェクトなどに関するユーザー選択情報が含まれます。

AUDIT_<machinename> という名前のログ ファイルは、%ProgramData%\QlikTech\QlikViewServer に保存されます。

注: QMC の [システム (System)] > [設定 (Setup)] > [QlikView Servers] > [ログ (Logging)] タブで [監査詳細ログを有効化 (Enable Extensive Audit Logging)] チェック ボックスを選択して詳細な監査ログを有効にします (ブックマークの付いているすべての選択をログするなど)。ただし、QVS におけるユーザー選択のログは、選択表示ボックス オブジェクトの動作を基に登録されます。そのため、選択数が多い場合その詳細はログに残らない可能性があります。
項目 説明
Server started QVS が開始された日付および時刻。
Timestamp ログ エントリが作成された日付および時刻。
Document アクセスしたドキュメントへのパスとその名前。
Type

選択やブックマークなど、行われた選択の種類。

使用できるタイプの概要については、下記の表をご覧ください。

User ユーザー名。
Message

選択の種類やドキュメントで作成されたアプリケーション ブックマークに関する情報 (たとえば、「Apply Server\Bookmark15」)。

このフィールドに表示される可能性のあるメッセージの概要については、下記のテーブルを参照してください。

エンドユーザーの監査ログのタイプとメッセージ項目に投稿されるタイプとメッセージは、下記に掲載されています。

注: エンドユーザーの監査ログでは、“XXX” と “YYY”は、QlikView ドキュメントの値で、置換されます。
タイプ メッセージ 説明
Action action (#) [XXX]

アクション # は XXX で実行されました。数値は次のアクションのうちの 1 つに対応します。

  • Info = 0
  • すべてをロック = 2
  • すべてをアンロック = 3
  • すべての選択をクリア = 4
  • ロック済みを含めすべての選択をクリア = 5
  • 元に戻す = 6
  • やり直し = 7
  • ファイルを閉じる = 8
  • 次のタブへ = 9
  • 前のタブへ = 10
  • エクスポート = 11
  • 起動 = 12
  • マクロ = 13
  • ブックマークの呼び出し = 14
  • ブックマークの上書き = 15
  • ブックマークの作成 = 16
  • レポートの印刷 = 17
  • シートの選択 = 18
  • シートの印刷 = 19
  • オブジェクトの印刷 = 20
  • オブジェクトを元のサイズに戻す = 21
  • オブジェクトを最小化する = 22
  • オブジェクトを最大化する = 23
  • オブジェクトを選択する = 24
  • 除外値の選択 = 25
  • 他項目の選択のクリア = 26
  • 絞込値の選択 = 27
  • ロック = 28
  • アンロック = 29
  • パレートの選択 = 30
  • 値を設定 = 31
  • 項目の選択 = 32
  • 項目の切り替え選択 = 33
  • URL を開く = 34
  • ドキュメント チェーン = 35
  • 項目の選択をクリア = 36
  • リロード = 37
  • 現在の選択条件を設定 = 38
  • 現在の選択条件を適用する = 39
  • 現在の選択条件の切り替え = 40
  • ダイナミック更新 = 41
Bookmark Apply XXX ブックマーク XXX は、適用されました。
Bookmark Selection XXX ブックマークが選択されたので、選択 XXX が行われました。このタイプの入力は、詳細な監査ログが選択された場合にのみ、記録されます。
Document Document XXX ドキュメント XXX は展開または閉じられました。
Export Sheet Object XXX シート オブジェクト XXX はエクスポートされました。
Maximize Sheet Object XXX シート オブジェクト XXX は最大化されました。
Minimize Sheet Object XXX シート オブジェクト XXX は最小化されました。
Print Sheet Object XXX シート オブジェクト XXX は印刷されました。
Report Accessed report XXX レポート XXX へのアクセスがありました。
Restore Sheet Object XXX シート オブジェクト XXX は復元されました。
Selection Clear All 全選択がクリアされました。
Selection XXX 選択 XXX が行われました。
SendToExcel Sheet Object XXX シート オブジェクト XXX が Microsoft Excel に送られました。
Sheet Object Sheet Object XXX シート オブジェクト XXX に適用できるさまざまなアクティビティ。
Session Collaboration Session Collaboration Initiated, ID:XXX ID XXX のセッションのコラボレーションが開始しました。
Session Collaboration Session Collaboration user XXX joined session, ID:YYY ユーザー XXX が、ID YYY のセッションのコラボレーションに参加しました。
Session Collaboration Session Collaboration user XXX left session, ID:YYY ユーザー XXX が、ID YYY のセッションのコラボレーションから脱退しました。

次のサンプルは、ブックマーク (“Bookmark01”) が選択された場合のログ エントリを示しています。ログは、全体を把握しやすくするためにテーブル形式で表示しています。

項目
Server started 20130506T101733.000+0900
Timestamp 20130506T102328.000+0900
Document C:\ProgramData\QlikTech\Documents\Test.qvw
Type ブックマーク
User QlikTech\jsmith
Message Apply Server\Bookmark01

詳細な監査ログが選択されている場合、ブックマークが選択されたために行われた選択の詳細を記すログ エントリ (複数可) が、上記のログ エントリの後に続く場合があります。これらログ エントリでは、「ブックマーク選択」にタイプ項目が設定されます。

マネージャの監査ログ

監査ログを使うと、システムのタスクや設定で行われた変更をトラッキングして、誰がいつその変更を行ったかを確認できます。

監査ログは %ProgramData%\QlikTech\ManagementService\AuditLog に保存されます。テーブルごとにフォルダが作成されます。各フォルダには、タスクへ行われた変更が記載された日付ごとのファイルが含まれます。ログは、タブ区切りファイルです。

ログに記載されるエントリは以下の通りです。

エントリ 説明
TransactionID トランザクション ID は、同時に行われた変更をトラッキングするのに便利です。
ChangeType 操作の種類: Update(新規や変更されたエントリ) もしくは Delete (削除済みエントリ)。
ModifiedTime 変更が行われた日付と時刻 (UTC)
ModifiedByUser ユーザー インターフェースで変更を行ったユーザー。Systemは、ユーザーではなくシステムが変更を行ったことを意味します。
ID 変更された (更新あるいは削除された) ID 行。

以下は、AlertEmailテーブルの例です。ログは、全体を把握しやすくするためにテーブル形式で表示しています。

TransactionID 455a241d-8428-4dc7-ba67-4ae7cb21cf3d
ChangeType Update
ModifiedTime 20100202T151254.000+0900
ModifiedByUser MyDomain\mjn
ID b3745325-cee7-4fe7-b681-9c9efe22fc5c
DistributionServiceID 8846d7dd-bb3f-4289-9c9b-b0ca71b7c3b2
EmailAddress mjn

以下は、QDSClusterテーブルの例です。2 つの例におけるTransactionIDは同じです。これは、変更が同時に行われたことを意味します。

TransactionID 455a241d-8428-4dc7-ba67-4ae7cb21cf3d
ChangeType Update
ModifiedTime 20100202T151254.000+0900
ModifiedByUser MyDomain\mjn
ID a37f242c-6d80-42da-a10c-1742d2ec927f
DistributionServiceID 8846d7dd-bb3f-4289-9c9b-b0ca71b7c3b2
QDSWebAdress http://computer-mjn:4720/qtxs.asmx
CurrentWorkorderID 96bff2dc-f1ea-84d2-b6c4-ea58bf5c98e5

タスク パフォーマンス サマリー

タスク パフォーマンス サマリーは、タスクのパフォーマンス情報の記録に使用します。

タスク パフォーマンス サマリーをアクティブにするには、次の手順を実行してください。

  1. テキスト エディタで Settings.ini ファイルを開きます。デフォルトでは、このファイルは次の場所に保存されています。
  2. C:\Windows\system32\config\systemprofile\AppData\Roaming\QlikTech\QlikViewBatch

  3. Settings.ini ファイル内にある次のセクションを見つけます。
  4. [Settings 7]

    InterfaceLanguage=English

    InstalledLIBID110={4D121C39-415E-11D1-934D-0040333C91CC}

  5. セクションの最後に EnableQVBProcessSummary=1 を追加し、タスク パフォーマンス サマリーをアクティブにします。
  6. 注: Settings.ini ファイルの最終行は空白にする必要があります。

  7. Settings.ini ファイルを保存します。
  8. QlikView Distribution Service (QDS) を再起動します。
  9. QDS の再起動が完了すると、タスク ログが更新されます。タスク出力の例を以下に挙げます。

    Name: qvb.exe, PID: 1360, Peak CPU: 50,0%, Peak Physical RAM: 26.00 Mb, Peak Virtual RAM: 21.69 Mb, Average CPU: 1,0%, Average Physical RAM: 24.47 Mb, Average Virtual RAM: 20.37 Mb, Peak Total CPU: 58,3%, Peak Total Physical RAM: 6143.49 Mb, Peak Total Virtual RAM: 12285.17 Mb, Elapsed Time: 00:00:36.4692722