Detalles de Object Storage

Detalles de registro para logs de Object Storage.

Recursos

buckets

Categorías de log


Valor de API (ID):	Consola (nombre mostrado)	Descripción
write	Eventos de acceso de escritura	Incluye logs para eventos de escritura.
read	Eventos de acceso de lectura	Incluye logs para eventos de lectura.

Disponibilidad

El registro de Object Storage está disponible en todas las regiones de los dominios comerciales.

Comentarios

Seleccione la categoría de log para el tipo de información que desea registrar. Por ejemplo, si activa un log de escritura, la propiedad requestAction tendría los valores PUT, POST o DELETE. Si activa un log de lectura, requestAction tendría los valores GET, LIST o HEAD.

Nota

Los logs de servicio de Object Storage se entregan realizando el mayor esfuerzo. En situaciones limitadas, es posible que un pequeño número de entradas de log no se entreguen correctamente.

Contenido de un log de Object Storage


Propiedad	Descripción
additionalDetails	Incluye los siguientes campos cuando se aplica al log en particular: versionId: de las respuestas PutObject y DeleteObject isDeleteMarker: de la respuesta DeleteObjectVersion retentionRuleName
apiType	API de origen de Object Storage: nativa compatible con s3 swift
authenticationType	Tipo de autenticación de solicitud: usuario servicio recurso instance
bucketCreator	OCID del creador del cubo
bucketId	OCID del cubo
bucketName	Nombre del cubo
clientIpAddress	Dirección IP del cliente de solicitud
compartmentId	OCID del compartimento
compartmentName	Nombre del compartimento
credentials	Credenciales de seguridad de solicitud
endTime	Registro de hora de finalización de solicitud
errorCode	Si está presente, se trata de un código de error corto para el análisis programático que define el error
eTag	Etiqueta de entidad (ETag) para el recurso
isPar	Booleano que describe si se trata de una solicitud autenticada previamente: true false
message	Cadena legible por el usuario que describe la solicitud
namespace	Espacio de nombres de Object Storage utilizado para la solicitud
objectName	Nombre del objeto
opcRequestId	Identificador de solicitud de cliente para el rastreo
principalId	OCID del solicitante
principalName	Nombre del solicitante
region	Identificador de región
requestAction	Método HTTP de la solicitud (DELETE/GET/HEAD/POST/PUT)
requestResourcePath	Ruta del recurso de la solicitud
startTime	Registro de hora de inicio de solicitud
statusCode	Código de estado de la respuesta
tenantId	OCID del arrendatario
tenantName	OCID del arrendatario
userAgent	Agente de usuario que ha enviado la solicitud a Object Storage

Ejemplo de log de Object Storage

{
   "time": "2020-09-10T19:04:11.324Z",
   "specversion": "1.0",
   "id": "2901893c-2140-491e-b23d-9cc6649fce67",
   "source": "MyBucket",
   "subject": "MyObject",
   "type": "com.oraclecloud.objectstorage.putobject",
    "data": {
      "additionalDetails": {
        "versionId": "7dec129d-ec60-470f-a153-f44af0ac15a6"
      },
      "apiType": "native",
      "authenticationType": "user",
      "bucketCreator": "ocid1.user.oc1..<unique_ID>",
      "bucketId": "ocid1.bucket.oc1.phx.<unique_ID>",
      "bucketName": "MyBucket",
      "clientIpAddress": "203.0.113.4",
      "compartmentId": "ocid1.compartment.oc1..<unique_ID>",
      "compartmentName": "MyObjectStore",
      "credentials": "<credentials>",
      "endTime": "2020-09-10T19:04:11.324Z",
      "isPar": false,
      "message": "Object uploaded.",
      "namespaceName": "MyNamespace",
      "objectName": "MyObject",
      "opcRequestId": "phx-1:7Tx5sjOAXOlcWKX5F-1Wjz_W2zF8aIeqW8PepNgsKHRlqKm3Mrot9IJAuZbQxBEI",
      "principalId": "ocid1.user.oc1..<unique_ID>",
      "principalName": "jane.smith@example.com",
      "region": "us-phoenix-1",
      "requestAction": "PUT",
      "requestResourcePath": "/n/MyNamespace/b/MyBucket/o/MyObject",
      "startTime": "2020-09-10T19:04:10.679Z",
      "statusCode": 200,
      "tenantId": "ocid1.tenancy.oc1..<unique_ID>",
      "tenantName": "MyTenancy",
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36"
    },
    "oracle": {
      "logid": "ocid1.log.oc1.phx.<unique_ID>",
    }
}

Nombre de objeto de log de Object Storage

Los objetos que almacenan datos de Object Storage utilizan el siguiente formato de nomenclatura:

public_log/<bucket_name>/<YYYY-MM-DDTHH_MMZ>[_<seqNum>].log.gz

Por ejemplo:

public_log/example_bucket/2019-03-21T00_00Z.log.gz
public_log/example_bucket/2019-03-21T00_00Z_2.log.gz

Uso de la Interfaz de Línea de Comandos (CLI)

Consulte Ejemplo de Object Storage para ver comandos de ejemplo.

Documentación de Oracle Cloud Infrastructure