Détails relatifs à Object Storage

Détails de journalisation pour les journaux Object Storage.

Ressources

  • buckets

Catégories de journal

Valeur d'API (ID) : Console (nom d'affichage) Description
write Evénements d'accès en écriture Inclut des journaux d'événements d'écriture.
read Evénements d'accès en lecture Inclut des journaux d'événements de lecture.

Disponibilité

La journalisation Object Storage est disponible dans toutes les régions des domaines commerciaux.

Commentaires

Choisissez la catégorie de journal pour le type d'informations à consigner. Par exemple, si vous activez un journal d'écriture, la propriété requestAction contient les valeurs PUT, POST ou DELETE. Si vous activez un journal de lecture, la propriété requestAction contient les valeurs GET, LIST ou HEAD.

Remarque

Les journaux de service pour Object Storage sont distribués dans les meilleurs délais possibles. Dans de rares cas, un petit nombre d'entrées de journal peuvent ne pas être distribuées.

Contenu d'un journal Object Storage

Propriété Description
additionalDetails

Inclut les champs suivants, le cas échéant :

  • versionId : à partir des réponses PutObject et DeleteObject
  • isDeleteMarker : à partir de la réponse DeleteObjectVersion
  • retentionRuleName
apiType API Object Storage d'origine :
  • native
  • s3-compatible
  • swift
authenticationType Type d'authentification de la demande :
  • user
  • service
  • resource
  • instance
resource OCID du créateur de bucket
bucketId OCID du bucket
bucketName Nom du bucket
clientIpAddress Adresse IP du client à l'origine de la demande
compartmentId OCID du compartiment
compartmentName Nom du compartiment
credentials Informations d'identification de sécurité de la demande
endTime Horodatage de fin de demande
errorCode Le cas échéant, code d'erreur court destiné à l'analyse par programmation qui définit l'erreur
eTag Balise d'entité (ETag) de la ressource
isPar Valeur booléenne indiquant s'il s'agit d'une demande pré-authentifiée :
  • true
  • false
message Chaîne lisible à l'oeil décrivant la demande
namespace Espace de noms Object Storage utilisé pour la demande
objectName Nom de l'objet
opcRequestId ID de demande client pour le traçage
principalId OCID du demandeur
principalName Nom du demandeur
region Identificateur de la région
requestAction Méthode HTTP de la demande (DELETE/GET/HEAD/POST/PUT)
requestResourcePath Chemin de ressource de la demande
startTime Horodatage de début de demande
statusCode Code de statut de réponse
tenantId OCID du locataire
tenantName OCID du locataire
userAgent Agent utilisateur qui a envoyé la demande à Object Storage

Exemple de journal 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>",
    }
}

Nom d'objet de journal Object Storage

Les objets qui stockent les données Object Storage utilisent le format de dénomination suivant :

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

Par exemple :

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

Utilisation de l'interface de ligne de commande (CLI)

Reportez-vous à Exemple dans Object Storage pour obtenir des exemples de commandes.