next

ログファイル取得

概要

イベントログファイルを取得します。

必要な権限

log-read

制限事項

計画されているログの出力設定は未サポートで、以下の固定設定が適用されます。

  • ログファイル名は"default.log"固定です。
  • ログサイズが一定の値に達したときローテートしてアーカイブされます。 (50MB)
  • ローテート時のファイル名は、 default.log.{Timestamp} となります。 {Timestamp}は、ローテートされたときの時刻です。
  • アーカイブは一定数のログファイルのみを保持します。（12世代）
  • アーカイブログが最大数に達したときには、最古のログが自動削除されます
アクションアーカイブされたログファイル説明備考
First Rotationarchive/
default.log.1402910774659
新規にローテートされたファイル
2014-06-16 18:26:14 +0900
2nd Rotationarchive/
default.log.1402910774659
default.log.1403910784659
前回ローテートされたファイル
新規にローテートされたファイル
2014-06-16 18:26:14 +0900
2014-06-28 08:13:04 +0900
3rd Rotationarchive/
default.log.1402910774659
default.log.1403910784659
default.log.1403910784659
前々回にローテートされたファイル
前回ローテートされたファイル
新規にローテートされたファイル
2014-06-16 18:26:14 +0900
2014-06-28 08:13:04 +0900
2014-07-09 21:59:44 +0900

リクエスト

リクエストURL

最新のログファイルを取得

{CellURL}__log/current/{LogName}

ローテートされたログファイルを取得

{CellURL}__log/archive/{LogName}

※{LogName}は、ログファイル情報取得API で返却されたファイル名を指定する。

メソッド

GET

リクエストクエリ

クエリ名概要有効値必須備考
p_cookie_peerクッキー認証値認証時にサーバから返却されたクッキー認証値×Authorizationヘッダの指定が無い場合のみ有効
クッキーの認証情報を利用する場合に指定する

リクエストヘッダ

共通リクエストヘッダ

ヘッダ名概要有効値必須備考
X-HTTP-Method-Overrideメソッドオーバーライド機能任意×POSTメソッドでリクエスト時にこの値を指定すると、指定した値がメソッドとして使用される
X-Overrideヘッダオーバライド機能${上書きするヘッダ名}:${値}×通常のHTTPヘッダの値を上書きします。複数のヘッダを上書きする場合はX-Overrideヘッダを複数指定する
X-Personium-RequestKeyイベントログに出力するRequestKeyフィールドの値半角英数、-(半角ハイフン)と_(半角アンダーバー)
最大128文字		×指定がない場合は、UUIDの独自短縮表現として${4桁}_${18桁}の形式のBase64url文字列を自動採番
AuthorizationOAuth2.0形式で、認証情報を指定するBearer {AccessToken}×※認証トークンは認証トークン取得APIで取得したトークン

リクエストボディ

なし

リクエストサンプル

なし

レスポンス

ステータスコード

200

レスポンスヘッダ

ヘッダ名概要備考
Content-TypeResourceのデータ形式に応じたMimeType"text/csv"または"application/zip"

レスポンスボディ

currentのログ取得時にログが存在しない場合は、空のレスポンスボディを返却する。
ローテートのサイズ設定値よりも5MB程度大きなサイズとなる場合がある。
出力形式は以下の通り。

{dateTime},[{level}],{RequestKey},{external},{schema},{subject},{type},{object},{info}
項目名概要備考
dateTimeログ書込み日時（ISO8601 UTC形式）YYYY-MM-DDTHH:MM:SS.sssZ
levelログレベル INFO,WARN,ERRORのいずれか文字列
RequestKeyX-Personium-RequestKeyヘッダで指定された値
X-Personium-RequestKeyヘッダ指定がない場合、PCS-${UUIDで32文字の文字列}		文字列
external外部イベント：true
内部イベント：false		文字列
schema受け付けたURLのboxのschemaURL形式
subjectイベントの主体URL形式
type外部イベント：イベント受付で定義されたtype
内部イベント：イベント毎に定義された型		文字列
object外部イベント：イベント受付で定義されたobject
内部イベント：リクエストされたリソースパス		文字列
info外部イベント：イベント受付で定義されたinfo
内部イベント：HTTPステータスコード		文字列

エラーメッセージ一覧

エラーメッセージ一覧を参照

レスポンスサンプル

外部イベント

2013-02-04T00:50:12.761Z,[INFO ],"Req_animal-access_1001","true","https://cell1.unit1.example/",
"https://unitadmin.unit1.example/#admin","authSchema","https://cell1.unit1.example/box1/service_name/token_keeper",
"[XXXX2033] Success schema authorization. cellUrl=https://keeper-d4a57bb26eae481486b07d06487051d1.unit1.example/"

内部イベント

2013-04-18T14:52:39.778Z,[INFO ],"PCS-1364350331902","false","https://app-cell1.unit1.example/",
"https://app-cell1.unit1.example/#staff","cellctl.Role.list","https://homeClinic.unit1.example/__ctl/Role","200"

cURLサンプル

curl "https://cell1.unit1.example/__log/current/default.log" -X GET -i \
-H 'Authorization: Bearer AA~PBDc...(省略)...FrTjA' -H 'Accept: application/json'
← Rule内部情報一覧取得ログファイル一覧取得 →