Oracle WebLogic Server RESTfulサーバー・ランタイム管理インタフェース

診断ログの検索

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:
####
  
   
    
     
     
       <[ACTIVE] ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'> 
      
        <> 
       
         <1549548507973> <[severity-value: 64] [rid: 0] [partition-id: 0] [partition-name: DOMAIN] > 
         
         
           ####
           
            
             
              
              
                <[ACTIVE] ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'> 
               
                 <> 
                
                  <1549548508037> <[severity-value: 64] [rid: 0] [partition-id: 0] [partition-name: DOMAIN] > 
                  
                  
                    nextRecordId=457

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

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

リクエストの例

curl -v \
--user admin:admin123 \
-H X-Requested-By:MyClient \
-H Accept:text/plain \
-H Content-Type:application/json \
-d "{
  limit: 2,
  fromId: 457,
  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)'> 
      
        <> 
       
         <1549548509983> <[severity-value: 64] [rid: 0] [partition-id: 0] [partition-name: DOMAIN] > 
         
         
           ####
           
            
             
              
              
                <[ACTIVE] ExecuteThread: '10' for queue: 'weblogic.kernel.Default (self-tuning)'> 
               
                 <> 
                
                  <1549548633097> <[severity-value: 64] [rid: 0:1] [partition-id: 0] [partition-name: DOMAIN] > 
                  
                  
                    nextRecordId=1432

トップに戻る