Le partitionnement des journaux est disponible dans toutes les régions et tous les domaines où Oracle Logging Analytics est disponible.

Si votre cas d'utilisation nécessite la fonction de partitionnement, soumettez un fichier Service Request à Oracle Support pour demander cette fonction dans Oracle Logging Analytics.

Vous pouvez collecter des journaux au moyen d'un agent de gestion autonome ou l'utiliser dans le cadre d'Oracle Cloud Agent.

1. Vous pouvez définir le jeu de journaux de plusieurs façons en modifiant le fichier emd.properties pour l'agent de gestion. Sélectionnez l'une des options suivantes :

   • Vous pouvez définir une valeur de jeu de journaux statique pour tous les journaux collectés par l'agent. Ajoutez la propriété suivante au fichier emd.properties de l'agent pour spécifier le jeu de journaux à l'échelle de l'agent :

     loganalytics.src.addl_src_ptn_configs=logset=<Value>

   • Définissez la valeur du jeu de journaux comme faisant partie du nom du fichier journal. Vous pouvez spécifier dans la configuration de l'agent une expression rationnelle pour définir comment extraire une partie du chemin du fichier journal en tant que chaîne de jeu de journaux. Dans le fichier de configuration emd.properties de l'agent, spécifiez les propriétés logsetkey et logSetExtRegex :

     loganalytics.src.addl_src_ptn_configs=logsetkey=logorigin,logSetExtRegex=<regex with a capture group>

     logorigin est le chemin d'accès au fichier journal.

   • Vous pouvez spécifier d'appliquer différentes extractions de jeu de journaux pour chaque source séparément en ajoutant l'ID source en tant que propriété aux paramètres ci-dessus.

     //sets this log set value only for source 201904301
     loganalytics.src.addl_src_ptn_configs=srcid=201904301,logset=<Value>

     //sets this log set value based on regular expression extraction only for source 201904301
     loganalytics.src.addl_src_ptn_configs=srcid=201904301,logsetkey=logorigin,logSetExtRegex=<regex with a capture group>

2. En plus de spécifier le jeu de journaux à l'aide de l'une des méthodes ci-dessus, incluez la propriété suivante dans le fichier de configuration emd.properties :

   loganalytics.src.override_config=true

3. Redémarrez l'agent après avoir modifié le fichier de configuration.

Actuellement, cette fonction n'est prise en charge que pour les journaux personnalisés collectés à partir du service de journalisation OCI dans Oracle Logging Analytics à l'aide du centre de connecteurs de service.

Pour définir la valeur du jeu de journaux, le journal personnalisé doit ajouter un nouveau champ au bloc data{} des données du format de journalisation unifié du service de journalisation pour OCI. Par exemple :

{
  "data": {
    "logSet": "<Value>",
    ...
  },
  "oracle": {
    ...
  },
    ...
}

Lors de la création d'une règle de collecte de stockage d'objets, les options utilisées pour alimenter le jeu de journaux dans la collection d'agents de gestion sont applicables.

• Vous pouvez définir une valeur de jeu de journaux statique pour tous les journaux collectés par cette règle de collecte de stockage d'objets. Ajoutez la propriété suivante au JSON de la règle de collecte de stockage d'objets :

  {
      "name": "<Object Collection Rule Name>",
      "logSet": "<Value>",
      ...
  }

• Vous pouvez spécifier une expression rationnelle pour analyser le jeu de journaux à partir du chemin d'accès à l'objet. Par exemple :

  {
      "name": "<Object Collection Rule Name>",
      "logSetExtRegex": "\\\/o\\\/[^\\\/]*\\\/([^\\\/]*)",
      ...
  }

• Si vous utilisez des remplacements dans la règle de collecte d'objets, vous pouvez également définir l'extraction du jeu de journaux pour le remplacement. Dans l'exemple suivant, tous les journaux collectés à partir du seau recevront le jeu de journaux Value1, à l'exception des objets qui correspondent au remplacement contenant db. Ces journaux obtiendront une chaîne de jeu de journaux capturée à partir de l'expression rationnelle dans le chemin d'accès à l'objet.

  {
      "name": "<Object Collection Rule Name>",
      "logSet": "Value1",
      "overrides": {
          "items": [{
              "matchType": "contains",
              "matchValue": "db",
              "propertyName": "logSetExtRegex",
              "propertyValue": "\\\/o\\\/[^\\\/]*\\\/([^\\\/]*)"
          }]
      }
  }

Lors de la publication des fichiers de données journaux vers le point d'extrémité d'API REST des événements de journal /actions/uploadLogEventsFile, vous pouvez spécifier le jeu de journaux dans les paramètres d'appel d'API REST POST. Toutes les données de journal chargées dans ce seul appel d'API seront stockées avec le même jeu de journaux.

Par exemple :

POST /20200601/namespaces/<namespaceName>/actions/uploadLogEventsFile?logGroupId=<logGroup_OCID>&payloadType=JSON&logSet=<Value>

Lorsque vous utilisez le collecteur fluentd, l'ensemble de journaux peut être extrait de n'importe quel autre champ (keyname). Spécifiez une expression rationnelle qui définit comment saisir la valeur de jeu de journaux attendue à partir du champ référencé par key_name dans le champ oci_la_log_set.

<filter oci.source>                  
  @type parser
  key_name oci_la_log_path      # The expression will be applied on the key "oci_la_log_path". You can pick any field that fluentd has parsed here.
  <parse>
    @type regexp
    expression '.*\/(?<oci_la_log_set>[^\.]{1,40}).*'   # Valid reg-ex for extraction
  </parse>
</filter>

Lorsque la valeur de oci_la_log_path est /n/axs4r325r2ct/b/logevents/o/fileType/logSetABC.log, la valeur du jeu de journaux extrait basée sur l'expression rationnelle ci-dessus est logSetABC.