ユーザーがアップロード操作を実行できるようにするには、アップロード・タスクの実行に必要な権限のみを選択的に付与するか、個々のリソース・タイプの権限を付与するか、またはより広範な集計レベルの権限を付与します。そのため、ユースケースに適した、次に示す3つのポリシー・ステートメントのセットのいずれかを選択できます。

次のIAMポリシー・ステートメントは、アップロード用のユーザー・グループに特定の権限を提供するためのものです:

allow group <group_name> to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment <log_group_compartment>

次のIAMポリシー・ステートメントは、アップロードの個々のリソース・タイプのレベルで権限を提供するためのものです:

allow group <group_name> to use loganalytics-log-group in compartment <log_group_compartment>

一方、次のIAMポリシー・ステートメントは、アップロードのOracle Logging Analytics集約リソース・レベルで権限を提供するためのものです:

allow group <group_name> to use loganalytics-resources-family in tenancy/compartment

前述のすべてのポリシー・ステートメントのgroup_nameは、必要な権限を付与する必要があるユーザー・グループを参照します。

REST APIおよび署名リクエストの使用の詳細は、REST APIおよびセキュリティ資格証明を参照してください。

uploadLogEventsFile APIのドキュメントは、ログ・アナリティクスAPI - uploadLogEventsFileを参照してください。

REST APIを使用してアップロードを実行するには、ホストで次のコマンドを実行します:

oci log-analytics upload upload-log-events-file --file <Json_Event_File_Path> --log-group-id <Log_Group_OCID> --namespace-name <Tenancy_Namespace_Name> --payload-type <Payload_Type>

前述のcurlコマンドでは、

• Json_Event_File_Path: JSONイベント・ファイルのパス。JSONイベント・ファイルの形式および例の詳細は、LogEvents APIを使用してアップロードするイベント・ファイル形式を参照してください。

• Tenancy_Namespace_Name: リクエストに使用されるOracle Logging Analyticsネームスペース。

• Log_Group_OCID: アップロードされたログがOracle Logging Analyticsに格納されるログ・グループのOCID。

• Payload_Type: デフォルトはJSONです。使用可能な値は、JSON、GZIP、ZIPです。

• Log_Set: アップロードされたログに関連付けられているログ・セット。このパラメータはオプション。

JSONペイロードの一般的な形式は次のとおりです。

{
    "metadata":{ ----------------------------------------> Global (file level) metadata section to send additional metadata in field value pair format. The fields should be valid Logging Analytics Fields
        "Field1":"Value1",
        "Field2":"Value2",
        "FieldN":"ValueN"
    },
    "logEvents":
    [ ---------------------------------------------------> Group the events (logRecords) that belong to the same logSourceName, entityId, logPath and metadata
        {
            "metadata":{ --------------------------------> Group level metadata section
                "FieldA”:”ValueA”,
                "FieldB”:”ValueB”,
                "FieldN":"ValueN"
            },
            "entityId”:”<EntityOCID>“, -------------------> Logging Analytics Entity OCID
            "logSourceName”:”<LogSourceName>”, -----------> Logging Analytics LogSource Name (Mandatory)
            "logPath”:”<LogPath>”, -----------------------> logPath or logFileName to associate the log records with.
            "logRecords": -------------------------------> Array of logRecords/logEntries (Mandatory)
            [
                "logRecord1", ---------------------------> String representation of logRecord. In case the logRecord is of JSON type, it has to be encoded.
                "logRecord2",
                "logRecordN"
            ]
        },
        {            …            …            …       }
    ]
}

次に、JSONペイロードの例を示します。

{
    "metadata":{
        "Error ID":"0",
        "Environment":"dev",
        "Client Host Region":"IST"
    },
    "logEvents":
    [
        {
            "metadata":{
                "Error ID":"1",
                "Environment":"prod",
                "Client Host Region":"PST"
            },
            "entityId":"ocid1.loganalyticsentity.oc1.iad.amaaaaa...........",
            "logSourceName":"Linux Syslog Logs",
            "logPath":"/var/log/messages",
            "logRecords":
            [
                “Oct 20 2023 04:02:37 hostA syslogd 1.4.1: restart.",
                “Oct 20 2023 04:02:38 hostB syslogd 1.4.1: shutdown."
            ]
        }
    ]
}