ジャンプ先

• リクエスト
• レスポンス
• 例

診断ログの検索

post

/management/weblogic/{version}/serverRuntime/WLDFRuntime/WLDFAccessRuntime/WLDFDataAccessRuntimes/{name}/search

この診断ログを検索し、結果を対応するサーバー側のログ・ファイルと同じテキスト形式で戻します。

リクエスト

サポートされているメディア・タイプ

• application/json

パス・パラメータ

• name: string
  コレクション内のインスタンスの名前プロパティ。
• version: string
  WebLogic RESTインタフェースのバージョン。

ヘッダー・パラメータ

• X-Requested-By: string
  X-Requested-Byヘッダーは、クロスサイト・リクエスト・フォージェリ(CSRF)攻撃からの保護に使用されます。値は、MyClientなどの任意の名前です。

本文()

次のフィールドが含まれている必要があります:

ルート・スキーマ: Search Criteria

タイプ: object

タイトル: Search Criteria

ソースを表示

• fromId(optional): integer(int64)

  このレコードIDで始まるレコード以降のみを返します。

  これは、一致した結果が指定されたlimitフィールドよりも多い場合に検索を続行するのに使用できます。前のレスポンスはnextRecordIdを返します。fromIdをその値に設定し、再度POSTすると検索を続行します。

  このフィールドはオプションです。

• lastMinutes(optional): integer(int64)

  最後のn分間にログインしたレコードのみを返します。

  このフィールドはオプションです。指定する場合、値は0(ゼロ)より大きい値である必要があります。

• limit(optional): integer(int64)

  返される一致レコードの最大数。

  利用可能なレコードがさらにある場合、レスポンスには一致する最も古いレコードに加えてnextRecordIdが含まれ、これは検索を続行するためにクライアントで(fromIdにその値を設定することにより)使用できます。

  このフィールドは指定する必要があります。値は0(ゼロ)より大きい値である必要があります。

• query(optional): string

  どのレコードが返されるかを制御するのに使用可能なオプションのフィルタ("SEVERITY = 'Info'"など)。詳細は、『Oracle WebLogic Server診断フレームワークの構成と使用』の「WLDF問合せ言語」を参照してください。

  このフィールドはオプションです。指定されない場合、レコードにフィルタは適用されません。

• since(optional): string

  この時間以後にログインしたレコードのみを返します。

  このフィールドはオプションです。指定する場合、形式は"yyyy-MM-dd'T'HH:mm:ss.SSSXXX" ("2016-05-24T13:44:02.349-04:00"など)、"yyyy-MM-dd'T'HH:mm:ss.SSSXX" ("2016-05-24T13:44:02.349-0400"など)、"yyyy-MM-dd'T'HH:mm:ss.SSSX" ("2016-05-24T13:44:02.349-04"など)のいずれかである必要があります。

• until(optional): string

  この時間より前にログインしたレコードのみを返します。

  このフィールドはオプションです。指定する場合、形式は"yyyy-MM-dd'T'HH:mm:ss.SSSXXX" ("2016-05-24T13:44:02.349-04:00"など)、"yyyy-MM-dd'T'HH:mm:ss.SSSXX" ("2016-05-24T13:44:02.349-0400"など)、"yyyy-MM-dd'T'HH:mm:ss.SSSX" ("2016-05-24T13:44:02.349-04"など)のいずれかである必要があります。

{
    "type":"object",
    "title":"Search Criteria",
    "properties":{
        "fromId":{
            "type":"integer",
            "format":"int64",
            "description":"<p>Only return records starting at this record id or later. </p><p>This can be used to continue a search that has more matching results than the specified <code>limit</code> field. The previous response will return a <code>nextRecordId</code>. Set <code>fromId</code> to that value and POST again to continue the search.</p><p>This field is optional.</p>"
        },
        "lastMinutes":{
            "type":"integer",
            "format":"int64",
            "description":"<p>Only return records that have been logged in the last n minutes.</p><p>This field is optional.  If specified, the value must be greater than zero.</p>"
        },
        "limit":{
            "type":"integer",
            "format":"int64",
            "description":"<p>The maximum number of matching records that will be returned.</p><p>If there are more available records, then the response will contain the oldest matching records, as well as a <code>nextRecordId</code> that the client can use to continue the search (by setting <code>fromId</code> to its value).</p><p>This field must be specified.  The value must be greater than zero.</p>"
        },
        "query":{
            "type":"string",
            "description":"<p>An optional filter that can be used to restrict which records are returned, for example \"SEVERITY = 'Info'\". See \"WLDF Query Language in Configuring and Using the Diagnostics Framework for Oracle WebLogic Server\" for more details.</p><p>This field is optional.  If not specified, then no filter is applied to the records.</p>"
        },
        "since":{
            "type":"string",
            "description":"<p>Only return records that were logged at this time or later.</p><p>This field is optional.  If specified it must be in one the following formats: \"yyyy-MM-dd'T'HH:mm:ss.SSSXXX\" (e.g. \"2016-05-24T13:44:02.349-04:00\"), \"yyyy-MM-dd'T'HH:mm:ss.SSSXX\" (e.g. \"2016-05-24T13:44:02.349-0400\") or \"yyyy-MM-dd'T'HH:mm:ss.SSSX\" (e.g. \"2016-05-24T13:44:02.349-04\").</p>"
        },
        "until":{
            "type":"string",
            "description":"<p>Only return records that were logged earlier than this time.</p><p>This field is optional.  If specified it must be in one the following formats: \"yyyy-MM-dd'T'HH:mm:ss.SSSXXX\" (e.g. \"2016-05-24T13:44:02.349-04:00\"), \"yyyy-MM-dd'T'HH:mm:ss.SSSXX\" (e.g. \"2016-05-24T13:44:02.349-0400\") or \"yyyy-MM-dd'T'HH:mm:ss.SSSX\" (e.g. \"2016-05-24T13:44:02.349-04\").</p>"
        }
    },
    "description":""
}

セキュリティ

• 管理者: 基本
  タイプ: basic

  説明: A user in the Admin security role.
• デプロイヤ: 基本
  タイプ: basic

  説明: A user in the Deployer security role.
• モニター: 基本
  タイプ: basic

  説明: A user in the Monitor security role.
• オペレータ: 基本
  タイプ: basic

  説明: A user in the Operator security role.

トップに戻る

レスポンス

サポートされているメディア・タイプ

• text/plain

200レスポンス

一致するレコードを対応するサーバー側のログ・ファイルと同じテキスト形式で戻します。レコードは時系列順になり、最も古いレコードが最初になります。

リクエスト本体で指定されたlimitより多くの一致するレコードがある場合、最も古いlimit件の一致するレコードが返され、nextRecordId=nnnの形式でレスポンスにさらに行が追加されます。これには次の一致するレコードのレコードIDが格納されます。クライアントは、lastMinutesやsinceを指定するかわりに、nextRecordIdの値にfromIdを設定してこのリソースに同じクエリーをPOSTすることにより検索を続行できます

本文()

ルート・スキーマ: Results

タイプ: string

タイトル: Results

トップに戻る

例

ログの検索を開始します。

この例では、POSTメソッドを使用してサーバー・ログのレコードの検索を開始し、結果をテキストとして返します。

リクエストの例

curl -v \
--user admin:admin123 \
-H X-Requested-By:MyClient \
-H Accept:text/plain \
-H Content-Type:application/json \
-d "{
  limit: 2,
  query: 'SEVERITY = \'Info' AND USERID = 'admin'',
  lastMinutes: 60
}" \
-X POST http://localhost:7001/management/weblogic/latest/serverRuntime/WLDFRuntime/WLDFAccessRuntime/WLDFDataAccessRuntimes/ServerLog/search

レスポンスの例

HTTP/1.1 200 OK

Response Body:
####
  
   
    
     
     
       <[STANDBY] ExecuteThread: '4' for queue: 'weblogic.kernel.Default (self-tuning)'> 
      
        <> <388d2efe-f1db-4e49-8a64-40abb9ff7f11-00000020> <1578492023965> <[severity-value: 64] [rid: 0] > 
        
        
          ####
          
           
            
             
             
               <[STANDBY] ExecuteThread: '4' for queue: 'weblogic.kernel.Default (self-tuning)'> 
              
                <> <388d2efe-f1db-4e49-8a64-40abb9ff7f11-00000020> <1578492023983> <[severity-value: 64] [rid: 0] > 
                
                
                  nextRecordId=518
                
               
              
             
            
           
          
         
        
       
      
     
    
   
  
 

ログの検索を続行します。

この例では、POSTメソッドを使用してサーバー・ログのレコードの検索を続行し、結果をテキストとして返します。

リクエストの例

curl -v \
--user admin:admin123 \
-H X-Requested-By:MyClient \
-H Accept:text/plain \
-H Content-Type:application/json \
-d "{
  limit: 2,
  fromId: 518,
  query: 'SEVERITY = \'Info' AND USERID = 'admin'',
}" \
-X POST http://localhost:7001/management/weblogic/latest/serverRuntime/WLDFRuntime/WLDFAccessRuntime/WLDFDataAccessRuntimes/ServerLog/search

レスポンスの例

HTTP/1.1 200 OK

Response Body:
####
  
   
    
     
     
       <[ACTIVE] ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'> 
      
        <> <388d2efe-f1db-4e49-8a64-40abb9ff7f11-00000026> <1578492025170> <[severity-value: 64] [rid: 0] > 
        
        
          ####
          
           
            
             
             
               <[ACTIVE] ExecuteThread: '2' for queue: 'weblogic.kernel.Default (self-tuning)'> 
              
                <> <388d2efe-f1db-4e49-8a64-40abb9ff7f11-0000004c> <1578492132470> <[severity-value: 64] [rid: 0:1] > 
                
                
                  nextRecordId=1421
                
               
              
             
            
           
          
         
        
       
      
     
    
   
  
 

トップに戻る