2.1.2.7 GWWSサーバーのトレース
GWWSサーバー・プロセスは、TuxedoでサポートされるTMTRACEトレース機能を使用します。GWWSのトレース機能はTMTRACEとともに使用されます。
トレース・メッセージは、ユーザー設定ディレクトリ内でアクセス可能なULOGファイルに記録されます。ULOGファイルを確認することで、問題の原因を特定できる場合があります。さらに、ULOGを参照することは、SALTゲートウェイでの問題がメッセージ処理のどのステージで発生したのかを特定するのに役立ちます。
トレースは、環境変数TMTRACEおよびGWWS_TRACE_LEVELを使用して有効化します。TMTRACE変数はトレースを有効化します。環境変数GWWS_TRACE_LEVELは、SALTゲートウェイで記録するトレース量を制御します。
atmi+wsと指定すると、Oracle SALTとOracle Tuxedo ATMIの両方のトレース・メッセージが記録されます。
ノート:
メッセージ・トレースは、診断処置にのみ使用することをお薦めします。GWWSサーバーでは、次のトリガー仕様はお薦めできません。abort,system, sleep
このいずれかのトリガーを指定した場合は、GWWSサーバーが予期せず終了することがあります。
詳細は、『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』の「tmtrace(5)」を参照してください
GWWS_TRACE_LEVELは、100または200に設定できます。値'100'では、最小限のトレース情報がULOGファイルに記録されます。値'200'では、最大限のトレース情報が記録されます。
TMTRACEおよびGWWS_TRACE_LEVELの各環境変数は、次のように設定できます:
export TMTRACE=atmi+ws:ulog
export GWWS_TRACE_LEVEL=100
トレースは、ATMIおよびSALTの両方のメッセージに対して有効です(最小トレース量)。
トレースをSALTメッセージにのみ有効にするには、次のように設定します:
export TMTRACE=ws:ulog
export GWWS_TRACE_LEVEL=200
ノート:
GWWS_TRACE_LEVELが200に設定されており、データ・バッファが大きい場合は特に、使用可能なディスク容量に注意する必要があります。トレースによってULOGファイルがいっぱいになる可能性があります。次の例は、SALTトレース・メッセージを含むULOGファイルの例を示しています。
例2-1 GWWSサーバーが記録したTMTRACEメッセージ
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:Begin data transformation of request message, buffer type = FML32, SCO index=4095
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:trace_level<100>:sco_index<4095>:WS<TFML32>:tuxedo_service<TFML32>:direction<inbound>:message_kind<request>:Parsing of the Data message begins before sending to tuxedo
…
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:Entering<TRACE_FSM>
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:SCO[4095] FSM State Transition: --OK-->FindService
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:Exiting<TRACE_FSM>
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:<200>:<4095>:<TFML32>:<TFML32>:<inbound>:<request>:<Message:Style/Encoding><DOC/LITERAL>
…
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:<runSoap2BufConversion> <200>:<4095>:<TFML32>:<TFML32>:<inbound>:<request>:Message config parameters info:input buffer<inbuf>:type<FML32>:schema-name<fml32_TFML32_In>:style<DOC>:encoding<LITERAL>:type<request-response>
…
105106.slc04jtu!GWWS.27653.1379895040.0: TRACE:ws:<100>:<4095>:<TFML32>:<TFML32>:<inbound>:<request>:<XML2Tux> data conversion SOAP to tuxedo completed
…
105106.slc04jtu!GWWS.27653.1388463872.0: TRACE:ws:<buffer2soap> trace_level<200>:sco_index<4095>:WS<TFML32>:tuxedo_service<TFML32>:direction<inbound>:message_kind<response>:Data will be converted to SOAP message:mode<Internal>:style/encoded<DOC>/<LITERAL>:endpoint<http://slc04jtu:12438/TuxAll>:buffertype<outbuf>
105106.slc04jtu!GWWS.27653.1388463872.0: TRACE:ws:<runBuf2SoapConversion> <200>:<4095>:<TFML32>:<TFML32>:<inbound>:<response>:Message config parameters info:output buffer<outbuf>:type<FML32>:schema-name<fml32_TFML32_Out>:style<DOC>:encoding<LITERAL>:type<request-response>
105106.slc04jtu!GWWS.27653.1388463872.0: TRACE:ws:<runBuf2SoapConversion> <200>:<4095>:<TFML32>:<TFML32>:<inbound>:<response>:type<FML32>:name<outbuf>
105106.slc04jtu!GWWS.27653.1388463872.0: TRACE:ws:<nestBuf2Soap> <200>:<4095>:<TFML32>:<TFML32>:<inbound>:<response>:type<BYTE>:schema-type<byte>:minOccur<1>:maxOccur<1>:name<tf32char>:value<0xFFFFFF80>
…
FML32>:<TFML32>:<inbound>:<response>:type<MBSTRING>:schema-type<string>:minOccur<1>:maxOccur<1>:name<tf32mbstr>:value<abcdefg>
ノート:
GWWSのトレース動詞のmsは非推奨になり、wsに置き換わりました。親トピック: GWWSサーバーのチューニング