システムログの検索

組織のOkta内のシステムログからログイベントを検索します。

スコープ

このカードで必要なOAuthスコープのリストは「アクションカード」を参照してください。

オプション

フィールド 定義 タイプ 必須

検索条件(Search By)

次のいずれかの検索オプションを選択します。

Expression: use System for Cross-domain Identity Management(SCIM)フィルター式を使用して、返すオブジェクトのサブセットを指定します。式フィルターは、ログイベント属性値に対する制約を明示的にターゲットにできる構造化クエリを実行する場合に役立ちます。式フィルタリングを使用する場合は、次の点を考慮してください。

  • 大きなオブジェクトコレクション(ユーザーなど)を検索する場合に使用します。
  • null値を含む属性に対してキーワードマッチングを実行した場合、値は返されません。

フィルタリング」を参照してください。

Keyword:完全なキーワードマッチングを使用します。クエリパラメータqは、ログイベントオブジェクトの属性値に対してキーワードマッチングを実行するために使用されます。キーワードマッチングを使用する場合は、次の点を考慮してください。

  • 入力したキーワードはすべて完全に一致する必要があります。
  • マッチングでは大文字と小文字が区別されます。
  • ログイベントオブジェクトの属性はキーワードマッチングとして使用できます。
  • null値を含む属性に対してキーワードマッチングを実行した場合、値は返されません。

キーワード」を参照してください。

ドロップダウン

結果セット(Result Set)

検索結果のフィルタリング方法を選択します。

  • First Matching Record:一致する最初のレコードが返されます。

  • First 200 Matching Records:最初に一致する200レコードを返します。

  • Stream Matching Records:一致するすべてのレコードが親フローからヘルパーフローに渡されます。

    このオプションを選択すると、ストリーミング用のヘルパーフローを選択したりカスタム拡張可能フィールドを追加したりできるストリーミング(Streaming)入力セクションがカードに追加されます。

ドロップダウン

入力

フィールド 定義 タイプ 必須

検索条件(Search By)

eq演算子を使用してキーと値の各ペアを連結してから、and演算子を使用して各種のキーを結合します。カスタムフィルター(Custom Filter)フィールドを使用して独自の式を構築します。それらの事前定義されたフィールドと[Custom Filter(カスタムフィルター)]フィールドは、andで連結します。

システムログ」を参照してください。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

イベントタイプ(Event Type)

公開されたイベントのタイプ。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

UUID

Webhookイベントの汎用一意識別子。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

表示メッセージ(Display Message)

イベントのメッセージを表示します。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

アクターID(Actor ID)

アクターの識別子。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

アクター表示名(Actor Display Name)

アクターの表示名。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

アクタータイプ(Actor Type)

アクターのタイプ。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

対象ID(Target ID)

対象の一意識別子。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

対象の表示名(Target Display Name)

対象の表示名。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

対象タイプ(Target Type)

ターゲットのタイプ。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

重大度(Severity)

イベントの重大度を示します。

  • DEBUG

  • INFO

  • WARN

  • ERROR

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

ドロップダウン FALSE

カスタムフィルター(Custom Filters)

ログイベントを検索するための独自のSCIMフィルター式を構築します。

例:

失敗したサインインイベントを検索するには、eventType eq "user.session.start"outcome.result eq "FAILURE"を使用します。

参照してください。

検索タイプ(Search Type) オプションでExpressionを選択した場合に表示されます。

テキスト FALSE

キーワード(Keyword)

1つ以上の正確なキーワードをログイベントの結果をフィルターします。

例:

  • 特定の市区町村を検索するには、都市名San Franciscoを入力します。

  • 特定の個人を検索するには、氏名firstName lastNameを入力します。

  • 参照してください。

検索タイプ(Search Type) オプションでKeywordを選択した場合に表示されます。

テキスト FALSE

日付(Date)

開始日時(Since)

ログイベントのpublishedプロパティの下限時刻をフィルターします。

将来のタイムスタンプを入力すると、エラーが発生します。このフィールドを未指定のままにした場合、デフォルト値はUntilの7日前です。

日時 FALSE

終了日時(Until)

ログイベントのpublishedプロパティの上限時刻をフィルターします。

将来のタイムスタンプを入力するか、このフィールドを未指定のままにした場合、現在のタイムスタンプが終了日時の値と見なされます。

日時 FALSE

並べ替え(Sort)

順序(Order)

publishedプロパティで並べ替えられる、返されるイベントの順序。次の中から選択します。

  • Ascending

  • Descending

ドロップダウン FALSE

ストリーミング(Streaming)

フロー(Flow)

フローの選択(Choose Flow)をクリックして検索結果がストリーミングされるヘルパーフローを参照および選択し、選択(Choose)をクリックして確定します。

オプションとして、クリックまたはここにドロップして作成(Click or drop here to create)の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、ヘルパーフロー内の州、都道府県(State)出力オブジェクトの下にキーと値のペアとして追加されます。

結果セット(Result Set)オプションでStream Matching Recordsが選択されている場合に表示されます。

フロー

TRUE

検索条件(Search Criteria)

レコード制限(Record Limit)

ストリーミングするレコードの数を指定します。

  • フィールドを0未満に設定すると、カードはエラーを返します。

  • フィールドを0または0より大きい値に設定すると、ストリームは指定された最大数までを返します。

  • フィールドを空またはnullにする、または選択しない場合、ストリームは全レコードを返します。

  • デフォルト値は1000000(100万)です。

  • 有効な範囲は01000000です。

このフィールドは、結果セット(Result Set)オプションでStream Matching Recordsを選択した場合に表示されます。

数値 FALSE

出力

特に指定がない限り、結果セット(Result Set)オプションでFirst Matching RecordまたはFirst 200 Matching Recordsを選択すると、フィールドが表示されます。

フィールド 定義 タイプ

結果(Result)

UUID

個々のイベントの一意識別子。

テキスト

公開済み(Published)

イベントが公開された日時のタイムスタンプ。

日時

イベントタイプ(Event Type)

公開されたイベントのタイプ。

テキスト

重大度(Severity)

イベントの重大度を示します。

  • DEBUG

  • INFO

  • WARN

  • ERROR

テキスト

表示メッセージ(Display Message)

イベントのメッセージを表示します。

テキスト

アクター(Actor)

アクションを実行するエンティティーを表します。

オブジェクト

ID (ID)

ユーザー特権を付与したOktaアクターの識別子。

テキスト

タイプ(Type)

Oktaアクターのタイプ。

テキスト

代替ID(Alternate ID)

Oktaアクターのユーザー名。

テキスト

表示名(Display Name)

Oktaアクターの表示名。

テキスト

ターゲット(Target)

アクションの0個以上の対象。

オブジェクトのリスト

クライアント(Client)

アクションをリクエストしたクライアント。

オブジェクト

ID (ID)

クライアントの一意の識別子。

  • OAuthリクエストの場合は、リクエストを行っているOAuthクライアントのIDです。ロール(Roles)を参照してください。

  • SSWSトークンリクエストの場合は、リクエストを行っているエージェントのIDです。

テキスト

ユーザーエージェント(User Agent)

アクションを実行するアクターによって使用されるユーザーエージェント。

オブジェクト

地理的コンテキスト(Geographical Context)

クライアントがリクエストを行っている物理的な場所。

オブジェクト

ゾーン(Zone)

クライアントの場所がマッピングされるゾーンの名前。

ゾーン」を参照してください。

テキスト

IPアドレス(IP Address)

クライアントがリクエストを行っているIPアドレス。

テキスト

デバイス(Device)

クライアントが操作しているデバイスのタイプ。

例:コンピューター

テキスト

リクエスト(Request)

アクションを開始するリクエスト。

オブジェクト

IPチェーン(IP Chain)

受信リクエストがプロキシを通る場合、それらのプロキシのIPアドレスが「clientIp, proxy1, proxy2」の形式でここに保存されます。このフィールドは信頼済みプロキシを使用する場合に役立ちます。

オブジェクトのリスト

Raw Output (未加工出力)

Okta APIによって返される未加工の出力。

オブジェクト

一致レコードのストリーミング(Stream Matching Records)

ストリーミングされたレコード(Records Streamed)

ストリーミングフロー内でストリーミングされたレコードの数。

このフィールドは、結果セット(Result Set)オプションでStream Matching Recordsを選択した場合に表示されます。

数値