Oracle TimesTen In-Memory Database APIリファレンス・ガイド

ttDaemonLog

説明

TimesTenは、TimesTenデーモン（WindowsではTimesTen Data Managerサービスと呼ばれます）と他のバックグラウンド・プロセス（サブデーモンおよびエージェント）を使用して、ユーザー・ログまたはエラー・ログへのアクセスを管理しています。

デフォルトでは、TimesTenメッセージは次のログに格納されます。

確認する必要がある情報が含まれるユーザー・エラー・ログ。通常、これらのメッセージには、必要な処置に関する情報が含まれています。

ユーザー・エラー・ログに含まれるすべての情報に加えて、Oracleサポート・サービスによって使用される情報が含まれるサポート・ログ。

ttDaemonLogユーティリティでは、TimesTenユーザー・ログおよびエラー・ログに書き込むイベントや、TimesTenユーザー・ログおよびエラー・ログからフェッチするイベントの種類を制御できます。

ttDaemonLogユーティリティには、次の2つのバージョンがあります。

Windows版ttDaemonLog

UNIX版ttDaemonLog

Windows版ttDaemonLog

Windowsでは、TimesTenユーザー・ログおよびエラー・ログのメッセージは、WindowsアプリケーションのEvent Logに書き込まれます。ttDaemonLogユーティリティは、ログに書き込むイベント、およびログからフェッチしてstdoutに表示するイベントを制御します。

構文

ttDaemonLog [-h | -help | -?]

ttDaemonLog [-V | -version] 
ttdaemonlog [-show type] [-b | -r | -s] [-f] [-integer] 
[-loglevel level [DSN | [-connstr] connStr]] 
[-[no]logcomponent component [DSN | [-connstr] connStr]] 
[-logreset] [-msg string] [-setquiet | -setverbose] 
[-n computer]

オプション

ttDaemonLogには次のオプションがあります。


オプション	説明
-b	TimesTenによって生成されたすべてのsyslogエントリを出力します。
`-f`	ログの終わりに達しても、ttDaemonLogは終了せずに継続し、定期的にイベント・ログのポーリングを行って、追加のTimesTenログ・レコードを検索して表示します。これは、リアルタイムで更新されるログ・データを表示する場合などに役立ちます。
`-h` `-help` -?	使用方法のメッセージを出力して終了します。
-integer	表示するログの最後の最大行数。`-f`が指定されている場合、デフォルトは40行です。0の場合、制限はありません。
-logcomponent component -nologcomponent	特定のコンポーネントを記録することを指定します。コンポーネントとしてDSNまたは接続文字列が指定されている場合、ロギングは指定されたデータ・ストアのみに適用されます。-nologcomponentが指定されている場合、指示されたコンポーネントに対してロギングは実行されません。 componentに指定できる値は、次のとおりです。 ALL DAEMON DAEMONDBG WEBSERVER REPLICATION ORACLECONNECT
-loglevel level	指定したlevel以上のメッセージを記録することを指定します。このオプションは、コンポーネントとしてDSNまたは接続文字列が指定されている場合、指定されたデータ・ストアにのみ適用されます。
-logreset	イベント・ロギング・パラメータをリセットします。
-msg string	TimesTenユーザー・ログにstringを挿入します。
-n computer	異なるコンピュータのログを表示します。対象のコンピュータの汎用命名規則（UNC）名を指定します。
-r	TimesTen Replication Agentのログのみを出力します（`-show replication`と同じです）。
-s	TimesTen Serverのログのみを出力します（ `-show server.`と同じです）。
-setverbose -setquiet	TimesTen冗長ロギングを有効（`-setverbose`）または無効（`-setquiet`）にします。
-show type	出力を指定したタイプに制限します。次のタイプがあります。 all: すべて表示します（デフォルト）。 replication: レプリケーション・エージェントのログ・エントリのみを表示します（`-r` オプションと同じです）。 ora: Cache Connectエージェントのログ・エントリのみを表示します。 server: TimesTen Serverのログ・エントリのみを表示します（`-s`オプションと同じです）。
`-V \| -version`	ttDaemonLogのリリース番号を出力し、終了します。

例

デフォルトでは、ttDaemonLogユーティリティでは、すべてのTimesTenコンポーネントのメッセージおよびエラーが記録されます。-nologcomponentオプションを設定すると、ログに書き込まれる範囲を絞り込むことができます。-nologcomponentオプションは、選択したデータ・ストアまたはすべてのデータ・ストアに適用できます。

たとえば、すべてのデータ・ストアのレプリケーションに関連するメッセージおよびエラーがログに書き込まれないようにするには、次のように入力します。

ttDaemonLog -nologcomponent replication

masterdsnデータ・ストアのレプリケーションに関連するメッセージおよびエラーがログに書き込まれないようにするには、次のように入力します。

ttDaemonLog -nologcomponent replication masterdsn

レプリケーションおよびCache Connectの両方のエラーおよびメッセージがログに書き込まれないようにするには、次のように入力します。

ttDaemonLog -nologcomponent replication

ttDaemonLog -nologcomponent oracleconnect

-nologcomponentオプションを設定した後にコンポーネントのエラーの書込みを再度有効にするには、-logcomponentオプションを使用します。たとえば、前述の例で示したように、レプリケーションおよびCache Connectの両方のエラーがログに書き込まれないようにした後にレプリケーション・エラーのログへの書込みを再度有効にするには、次のように入力します。

ttDaemonLog -logcomponent replication

すべてのTimesTenコンポーネントのログへの書込みを再度有効にするには、次のように-logresetオプションを使用します。

ttDaemonLog -logreset

ローカル・マシン上のTimesTenのデーモンおよびサーバーからのすべての出力を表示するには、次のように入力します。

ttDaemonLog

backup1というホスト・マシンからのログ出力を表示するには、次のように入力します。

ttDaemonLog -n backup1

ファイルC:\TimesTen\logout\log1にログ出力を書き込むには、次のように入力します。

ttDaemonLog -file C:\TimesTen\logout\log1

TimesTen Serverは、アプリケーションがクライアントDSNに接続されるか、またはクライアントDSNから切断されるたびにメッセージを生成します。ただし、インストール時にこれらのメッセージの生成が指定されている場合のみです。サーバー・ログ・メッセージのみを表示するには、次のように入力します。

ttDaemonLog -show server

レプリケーション・エージェント・メッセージのみを表示するには、次のように入力します。

ttDaemonLog -show replication

キャッシュ・エージェント・メッセージのみを表示するには、次のように入力します。

ttDaemonLog -show ora

TimesTenプロセスからのすべてのメッセージを表示するには、次のように入力します。

ttDaemonLog -show all

ロギングをデフォルトの冗長レベルにリストアするには、-setverboseオプションを使用します。

ttDaemonLog -setverbose

注意

この情報は、主にOracleサポート・サービスによる使用を目的としていますが、システム管理者およびシステム開発者に役立つ場合もあります。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

冗長ロギングを永続的に設定または無効にするには、ttendaemon.optionsファイルのオプションを変更する必要があります。『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のOracle TimesTen Data Managerデーモンでの処理の項で、情報メッセージの変更に関する説明を参照してください。

UNIX版ttDaemonLog

説明

UNIXでは、ttDaemonLogは、syslogd(1)によって生成されるファイルからすべてのTimesTenイベントをフェッチします。すべてのイベントはstdout.に表示されます。

TimesTenデーモン（timestend）は syslog(2)を介してそのイベント・ログを記録します。ログ情報の最終的な処理は/etc/syslog.confファイルの設定に依存し、ログをカスタマイズしたり、選択的にメッセージを無視したりすることができます。ファイルの設定によって、メッセージを様々なファイルに記録することができます。これらのファイルはかなり大きくなる可能性があります。そのため、これらのファイルは定期的に削除して、ディスク領域を確保する必要があります。

構文

オプション

ttDaemonLogには次のオプションがあります。


オプション	説明
-b	TimesTenによって生成されたすべてのsyslogエントリを出力します。
`-f`	ログの終わりに達しても、ttDaemonLogは終了せずに継続し、定期的にイベント・ログのポーリングを行って、追加のTimesTenログ・レコードを検索して表示します。これは、リアルタイムで更新されるログ・データを表示する場合などに役立ちます。
-facility name	使用されているsyslog機能名を指定します。
-file filename	TimesTenがメッセージを記録するファイルを指定します。指定しない場合は、システムの`syslog`設定が調べられ、TimesTenメッセージの記録先が決定されます。
`-h` `-help` -?	使用方法のメッセージを出力して終了します。
-integer	表示するログの最後の最大行数。`-f`が指定されている場合、デフォルトは40行です。0の場合、制限はありません。
-logcomponent component -nologcomponent	すでに記録されている他のコンポーネントとともに、特定のコンポーネントを記録することを指定します。コンポーネントとしてDSNまたは接続文字列が指定されている場合、ロギングは指定されたデータ・ストアのみに適用されます。`-nologcomponent`が指定されている場合、指定されたコンポーネントに対してロギングは実行されません。 componentに対して指定できる値は、次のとおりです。 ALL DAEMON DAEMONDBG WEBSERVER REPLICATION ORACLECONNECT
-loglevel level	指定したlevel以上のメッセージを記録することを指定します。このオプションは、コンポーネントとしてDSNまたは接続文字列が指定されている場合、指定されたデータ・ストアにのみ適用されます。
-logreset	イベント・ロギング・パラメータをリセットします。
-msg string	TimesTenユーザー・ログにstringを挿入します。
-r	TimesTen Replication Agentのログのみを出力します（`-show replication`と同じです）。
-s	TimesTen Serverのログを出力します（ `-show server.`と同じです）。
-setverbose -setquiet	TimesTen冗長ロギングを有効（`-setverbose`）または無効（`-setquiet`）にします。
-show type	出力を指定したタイプに制限します。次のタイプがあります。 all: すべて表示します（デフォルト）。 replication: レプリケーション・エージェントのログ・エントリのみを表示します（`-r` オプションと同じです）。 ora: Cache Connectエージェントのログ・エントリのみを表示します。 server: TimesTen Serverのログ・エントリのみを表示します（`-s`オプションと同じです）。
`-V \| -version`	ttDaemonLogのリリース番号を出力し、終了します。

例

-nオプションの例を除いて、「Windows版ttDaemonLog」に示されているすべての例は、UNIX版ttDaemonLogにも適用されます。次に、いくつかのUNIX固有のオプションの使用方法を示します。

ファイル/var/adm/syslog/syslog.logにログ出力を書き込むには、次のように実行します。

ttDaemonLog -file /var/adm/syslog/syslog.log

ロギングをlocal7機能に送るには、次のように入力します。

ttDaemonLog -facility local7

注意

この情報は、主にOracleサポート・サービスによる使用を目的としていますが、システム管理者およびシステム開発者に役立つ場合もあります。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

syslogの設定については、情報メッセージの変更に関する説明を参照してください。