本文へスキップ

Splunk Event Schema ドキュメント

LogEntry

タイトル ログエントリ

Typeobject
RequiredNo
Additional properties[Any type: allowed]

説明 Equinix Observability Serviceの顧客向けログフォーマットです。

{
"stream": {
"streamId": "b47f2eaf-d5c6-485c-a081-5d12333aa2e2",
"streamName": "Example Stream"
},
"source": {
"category": "validation",
"type": "validation_request",
"service": "metal",
"organizationId": "a2337a57-4ad0-4708-abc6-c0973055c91e"
},
"schema": "v1",
"timestamp": "2024-04-16T14:58:21.442334Z",
"level": "INFO",
"eventId": "e6de0ec4-027e-4733-aeb4-058c1fc53493",
"event": {
"eventName": "instance_provision_requested",
"status": "unauthorized",
"auth": {
"authType": "user",
"user": {
"userId": "1bec4119-a889-4809-89e9-c4572dc002ec",
"userName": "jdoe@equinix.com"
},
"role": {
"roleName": "collaborator"
}
},
"httpRequest": {
"host": "api.equinix.com",
"method": "PUT",
"path": "/metal/v1/projects/99f8e7f1-fe4a-441a-ade9-687743f080f6",
"scheme": "https",
"statusCode": 200,
"userAgent": "metal-cli/metal equinix-sdk-go/0.30.0",
"sourceIpAddress": "111.111.111.11"
},
"response": {}
}
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ streamNoobjectNo-Stream
+ sourceNoobjectNo-Source
+ schemaNoenum (of string)No-Indicates the schema version of this log entry.
+ timestampNostringNo-The timestamp at which this log entry was produced, in ISO8601 format.
+ levelNostringNo-A human-readable indication of the severity level of this log entry.
+ eventIdNostringNo-Unique identifier for this log event.
+ eventNoobjectNo-Event

1.プロパティ LogEntry > stream

タイトル ストリーム

Typeobject
RequiredYes
Additional properties[Any type: allowed]

説明 このログエントリを生成した可視性ストリームに関するメタデータを提供します。複数のストリームが同じ宛先に書き込まれている状況で、データソースを区別するために使用できます。

{
"streamId": "e55f79d4-0d8a-4460-a566-ff93af4f90e4",
"streamName": "Example Stream"
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ streamIdNostringNo-Unique identifier of the observability stream that produced this log entry.
+ streamNameNostringNo-Name of the observability stream that produced this log entry.

1.1.プロパティ LogEntry > stream > streamId {#stream_streamId}.

Typestring
RequiredYes
Formatuuid

説明 このログエントリを生成した可視性ストリームの一意の識別子。

1.2.プロパティ LogEntry > stream > streamName {#stream_streamName}.

Typestring
RequiredYes

説明 このログエントリを生成した可視性ストリームの名前。

"Example Stream"

2.プロパティ LogEntry > source

タイトル ソース

Typeobject
RequiredYes
Additional properties[Any type: allowed]

説明 このログエントリの発信元に関するメタデータを提供します。

{
"category": "audit",
"type": "api_request",
"service": "metal",
"organizationId": "0e714017-6d9c-4dc5-828d-b8a156502496"
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ categoryNoenum (of string)No-Groups logs into high-level application categories.
+ typeNoenum (of string)No-Differentiates types of log events withing a particular category.
+ serviceNoenum (of string)No-Indicates the service that produced this log entry.
+ organizationIdNostringNo-Indicates the customer Organization ID with which this log entry is associated.
- projectIdNostringNo-Indicates the customer Project ID with which this log entry is associated.

2.1.プロパティ LogEntry > source > category {#source_category}.

Typeenum (of string)
RequiredYes

説明 ログを高レベルのアプリケーションカテゴリーにグループ化します。

のいずれかでなければなりません:

  • 監査
  • 「バリデーション

2.2.プロパティ LogEntry > source > type {#source_type}.

Typeenum (of string)
RequiredYes

説明 特定のカテゴリ内のログイベントのタイプを区別します。

のいずれかでなければなりません:

  • "api_request"
  • "validation_request"

2.3.プロパティ LogEntry > source > service {#source_service}.

Typeenum (of string)
RequiredYes

説明 このログエントリを作成したサービスを示します。

のいずれかでなければなりません:

  • 「メタル

2.4.プロパティ LogEntry > source > organizationId {#source_organizationId}.

Typestring
RequiredYes
Formatuuid

説明 このログエントリが関連付けられている顧客の組織 ID を示します。

2.5.プロパティ LogEntry > source > projectId {#source_projectId}.

Typestring
RequiredNo
Formatuuid

説明 このログエントリが関連付けられている顧客のプロジェクトIDを示します。

3.プロパティ LogEntry > schema

Typeenum (of string)
RequiredYes

説明 このログエントリのスキーマバージョンを示します。

のいずれかでなければなりません:

  • "v1"

4.プロパティ LogEntry > timestamp

Typestring
RequiredYes
Formatdate-time

説明 このログエントリが作成されたタイムスタンプ(ISO8601 形式)。

"2024-04-16T14:58:21.442334Z"

5.プロパティ LogEntry > level

Typestring
RequiredYes

説明 このログエントリの重大度レベルを示す、人間が読める表示。

"INFO"

6.プロパティ LogEntry > eventId

Typestring
RequiredYes
Formatuuid

説明 このログイベントの一意の識別子。

7.プロパティ LogEntry > event

タイトル イベント

Typeobject
RequiredYes
Additional properties[Any type: allowed]

説明 アプリケーション固有のログイベントペイロード。将来、具体的なフォーマットはソースカテゴリとタイプによって異なりますが、今のところ、単一のログイベントスキーマを使用します。

{
"eventName": "project_updated",
"status": "unauthorized",
"auth": {
"authType": "user",
"user": {
"userId": "1bec4119-a889-4809-89e9-c4572dc002ec",
"userName": "jdoe@equinix.com"
},
"role": {
"roleName": "collaborator"
}
},
"httpRequest": {
"host": "api.equinix.com",
"method": "PUT",
"path": "/metal/v1/projects/99f8e7f1-fe4a-441a-ade9-687743f080f6",
"scheme": "http",
"statusCode": 200,
"userAgent": "metal-cli/metal equinix-sdk-go/0.30.0",
"sourceIpAddress": "111.111.111.11"
},
"resource": {},
"response": {}
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ eventNameNostringNo-An application-provided name for the event. Event names should be fixed by the application
(i.e. should not vary based on request parameters) to enable filtering/querying by the customer, and should carry
meaning to the customer. In the case of API request logs, this would correspond to an operation name.
+ statusNostringNo-An indication of the status associated with the event, e.g. request success/failure.
+ authNoobjectNo-AuthInfo
+ httpRequestNoobjectNo-HttpRequest
- resourceNoobjectNo-The resource associated with the request (for future use)
- requestNoobjectNo-Detailed request parameters (for future use)
- responseNoobjectNo-Detailed response body (for future use)

7.1.プロパティ LogEntry > event > eventName {#event_eventName}.

Typestring
RequiredYes

説明 アプリケーションによって提供されるイベント名。イベント名は、顧客によるフィルタリング/クエリを可能にするために、アプリケーションによって固定されるべきであり(すなわち、リクエストパラメータに基づいて変化すべきではない)、顧客にとって意味を持つべきです。API リクエストログの場合、これはオペレーション名に相当します。

"project_updated"
"instance_provision_requested"

7.2.プロパティ LogEntry > event > status {#event_status}.

Typestring
RequiredYes

説明 リクエストの成功/失敗など、イベントに関連するステータスの表示。

"success"
"failed"
"unauthorized"

7.3.プロパティ LogEntry > event > auth {#event_auth}.

タイトル AuthInfo

Typeobject
RequiredYes
Additional properties[Any type: allowed]

説明 説明:ログ・イベントに関連付けられた本人に関する認証および承認情報をプロバイダ。ほとんどの場合、これはリクエストを行った人です。

{
"authType": "user",
"user": {
"userId": "1bec4119-a889-4809-89e9-c4572dc002ec",
"userName": "jdoe@equinix.com"
},
"role": {
"roleName": "collaborator"
}
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ authTypeNoenum (of string)No-Indicates the type of entity for the principal associated with the request.
+ userNoobjectNo-User
+ roleNoobjectNo-Role

7.3.1.プロパティ LogEntry > event > auth > authType {#event_auth_authType}.

Typeenum (of string)
RequiredYes

説明 リクエストに関連付けられたプリンシパルのエンティティタイプを示します。

のいずれかでなければなりません:

  • "user"

7.3.2.プロパティ LogEntry > event > auth > user {#event_auth_user}.

タイトル ユーザー

Typeobject
RequiredYes
Additional properties[Any type: allowed]

説明 ログイベントに関連付けられたユーザーに関する識別情報を提供します。

{
"userId": "1bec4119-a889-4809-89e9-c4572dc002ec",
"userName": "jdoe@equinix.com"
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ userIdNostringNo-Unique user identifier; this is an opaque system-assigned ID that is not expected to be recognizable to people.
+ userNameNostringNo-Provides a more human-friendly display name for the user.
7.3.2.1.プロパティ LogEntry > event > auth > user > userId {#event_auth_user_userId}。
Typestring
RequiredYes

説明 一意のユーザー識別子。これは不透明なシステム割り当てIDで、人が認識できることは想定されていません。

"1bec4119-a889-4809-89e9-c4572dc002ec"
7.3.2.2.プロパティ LogEntry > event > auth > user > userName {#event_auth_user_userName}。
Typestring
RequiredYes

説明 ユーザーにより親しみやすい表示名をプロバイダに提供します。

"jdoe@equinix.com"

7.3.3.プロパティ LogEntry > event > auth > role {#event_auth_role}.

タイトル 役割

Typeobject
RequiredYes
Additional properties[Any type: allowed]

説明 説明:ログイベントに関連付けられたロールに関する情報をプロバイダします。プリンシパルが複数のロールにアクセスできる場合、これは、リクエストを行ったときに想定したロールを示します。

{
"roleName": "collaborator"
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ roleNameNostringNo-The human-friendly display name for the role.
7.3.3.1.プロパティ LogEntry > event > auth > role > roleName {#event_auth_role_roleName}。
Typestring
RequiredYes

説明 ロールの人間にとって使いやすい表示名。

"collaborator"

7.4.プロパティ LogEntry > event > httpRequest {#event_httpRequest} {#event_httpRequest

タイトル: HttpRequest

Typeobject
RequiredYes
Additional properties[Any type: allowed]

説明 ログイベントに関連付けられた HTTP リクエストの詳細をプロバイダに提供します。

{
"host": "api.equinix.com",
"method": "PUT",
"path": "/metal/v1/projects/99f8e7f1-fe4a-441a-ade9-687743f080f6",
"scheme": "http",
"statusCode": 200,
"userAgent": "metal-cli/metal equinix-sdk-go/0.30.0",
"sourceIpAddress": "111.111.111.11"
}
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ hostNostringNo-The hostname to which the original HTTP request was made.
+ methodNostringNo-The HTTP request method.
+ pathNostringNo-The path portion of the original HTTP request URL.
+ schemeNoenum (of string)No-The HTTP request scheme
+ statusCodeNointegerNo-The HTTP status code that resulted from the processing of the request.
+ userAgentNostringNo-The user-agent that issued the request, as reported by the HTTP client.
+ sourceIpAddressNostringNo-The IP address from which the HTTP request was sent.

7.4.1.プロパティ LogEntry > event > httpRequest > host {#event_httpRequest_host} {#event_httpRequest_host} 7.4.1.

Typestring
RequiredYes

説明 元の HTTP リクエストが送信されたホスト名。

"api.equinix.com"

7.4.2.プロパティ LogEntry > event > httpRequest > method {#event_httpRequest_method}。

Typestring
RequiredYes

説明 HTTP リクエストメソッド。

"PUT"

7.4.3.プロパティ LogEntry > event > httpRequest > path {#event_httpRequest_path} {#event_httpRequest_path}。

Typestring
RequiredYes

説明 元の HTTP リクエスト URL のパス部分。

"/metal/v1/projects/99f8e7f1-fe4a-441a-ade9-687743f080f6"

7.4.4.プロパティ LogEntry > event > httpRequest > scheme {#event_httpRequest_scheme} {#event_httpRequest_scheme}。

Typeenum (of string)
RequiredYes

説明 HTTPリクエストスキーム

のいずれかでなければなりません:

  • "http"
  • "https"

7.4.5.プロパティ LogEntry > event > httpRequest > statusCode {#event_httpRequest_statusCode} {#event_httpRequest_statusCode}。

Typeinteger
RequiredYes

説明 リクエストの処理結果の HTTP ステータスコード。

200

7.4.6.プロパティ LogEntry > event > httpRequest > userAgent {#event_httpRequest_userAgent} {#event_httpRequest_userAgent}。

Typestring
RequiredYes

説明 HTTP クライアントが報告する、リクエストを発行したユーザーエージェント。

"metal-cli/metal equinix-sdk-go/0.30.0"

7.4.7.プロパティ LogEntry > event > httpRequest > sourceIpAddress {#event_httpRequest_sourceIpAddress}。

Typestring
RequiredYes

説明 HTTP リクエストの送信元 IP アドレス。

"111.111.111.11"

7.5.プロパティ LogEntry > event > resource {#event_resource}.

Typeobject
RequiredNo
Additional properties[Any type: allowed]

説明 リクエストに関連付けられたリソース(将来使用するため)

{}

7.6.プロパティ LogEntry > event > request {#event_request}。

Typeobject
RequiredNo
Additional properties[Any type: allowed]

説明 詳細なリクエストパラメータ(将来使用するため)

{}

7.7.プロパティ LogEntry > event > response {#event_response}.

Typeobject
RequiredNo
Additional properties[Any type: allowed]

説明 詳細な回答本文(将来使用するため)

{}

Generated using json-schema-for-humans on2024/07/19 at 16:25:20 -0500

このページは役に立ちましたか?