Skip to content

Coralogix Audit

Overview

Users with audit permissions can utilize Coralogix audit logs to monitor organizational activity within Coralogix, including all user actions and API operations. This tool empowers you to track actions, ensure compliance, and maintain transparency across your team or organization.

Use Coralogix Audit to:

  • Review infrastructure-related user activities like payment or resource configuration changes.
  • Track before-and-after states of any system changes.
  • Monitor API operations during specific timeframes — from the API call or request, to the resulting action, and its outcome.
  • Create analytics to evaluate activity across your account by product.

How it works

Audit events from all teams are centralized within a designated audit team. With Audit v2, events are logged and delivered to the audit team in real-time as they occur (e.g., when a query is executed or an API operation takes place). These events follow a standardized structure, ensuring efficient querying and compliance-focused analysis.

Permissions

To view or manage audit team settings, users must have the required permissions:
ResourceActionDescription
team-auditingReadConfigView team audit settings
team-auditingUpdateConfigManage team audit settings

Membership in the audit team allows you to view audit events.

Setup

Access Audit

To access Coralogix Audit, navigate to Settings > Audit Account.

Create an audit team

STEP 1. Click on Create new audit team.

STEP 2. Once the team is configured, you can either open the activity of your entire team by clicking Open audit history or monitor the activity of a specific user by clicking on User audit history.

auditv2_create_step2.png

You will be rerouted to Explore to view the relevant audit events in the audit team environment.

Audit team settings

Attaching additional teams to an audit team

Once you have created an audit team for your organization, click Attach to connect other new teams to the audit team.

auditv2_attach.png

Change your audit team

Change your audit team by clicking Change audit account.

Migrate from Audit v1 to v2

We strongly recommend that existing users migrate to Audit v2 for enhanced functionality.

  • Enable v2 by toggling the switch to activate the new feature.

auditv2_enable.png

  • During the transition, v1 logs will continue to be sent to your audit account.
  • To filter exclusively v1 events:

    DataPrime

    source logs | filter $d.audit_schema_version == 'v1'

    Lucene

    audit_schema_version:"v1"

  • To filter exclusively v2 events:

    DataPrime

    source logs | filter $d.auditVersion == 'v2'

    Lucene

    auditVersion:"v2”

  • Once you’ve confirmed v2 is functioning as expected, you can disable v1 logs using the toggle in your settings. Any dashboards, alerts, or features configured with Audit v1 events will cease to function. Users must manually recreate these configurations to ensure functionality with Audit v2.

Note

  • During the transition, both v1 and v2 logs will contribute to your data usage. Be mindful of your audit account quota. Contact your CS representative if you anticipate exceeding your quota.
  • In v2 logs the application name remains unchanged (it’s equal to the teamName), but the subsystem name is changed from service to feature group.

Billing & usage

The audit team has a daily quota of up to 0.025 GB and a retention period of 7 days.

This quota should generally be sufficient for audit purposes. However, using the quota management CLI, you can increase it or reallocate it between teams if needed.

Configure your S3 archive to retain audit logs for longer periods. You can query these logs in Explore or use Background Queries for long-running queries.

Audit events structure

Events follow a unified structure, comprising an audit envelope and an audit payload. Payloads are standardized per event type (e.g., after for create, before/after for update, etc.).

Audit envelope

The envelope structure consists of the following fields:
FieldDescription
auditVersionAudit log structure version (e.g., v2, v3, etc.).
eventNameThe name of the event reflects its related features and functionality.
cxFeatureThe specific Coralogix feature the event data is related to.
cxFeatureGroupStable Coralogix feature groups, used as the subsystem name of each audit event.
eventKindThe type of the event (Action/Update/Delete/Create/Get/List). eventData payload structure is determined by this key.
endpointInfoProvides connection information, like the protocol used to connect to the system, the IP address that sent the request, and the request protocol.
authDetailsAuthentication details that depend on the type of authentication (API key, user login, or internal context).
actorDetailsDetails about the actor responsible for the action (organization, user, or team).
eventDataThe event payload, which contains details about the resources affected by the event and/or the resources themselves.
outcomeThe logical outcome of the actions. Contains the outcome status and failure type if relevant.

Example

 {
    "endpointInfo":{
        "clientInfo":{
            "ipAddress": <ip_address>,
            "userAgent": <user_agent>
        },
        "protocol": "HTTP",
        "httpDetails": {
            "statusCode": 200
        }
    },
    "cxFeatureGroup": "metrics",
    "actorDetails": {
        "actorType": "User",
        "username": <username>,
        "teamId": <team_id>,
        "teamName": <team_name>,
        "orgName": <org_name>
    },
    "auditVersion": "v2",
    "eventData": { 
        ...
    },
    "eventKind": "Action",
    "eventName": "logs-data-api.ReadData",
    "authDetails": {
        "authType": <Api Key>,
        "apiKeyId": <api_key_id>,
        "apiKeyName": <api_key_name>,
        "apiKeyOwnerType": <User>
    },
    "outcome": {
        "status": "Success",
        "statusMessage": "200 OK"
    },
    "cxFeature": "metrics.data-api"
}

Audit payload

Event type

Each event type has a common payload structure, which is contained in the eventData field and is determined by the event type (eventKind field).

Note

Large payloads are converted to strings and contained in the stringifiedEventData field for increased indexing efficiency.

  • Action

    Contains complex event data with varying structure.

  • List

    Contains a filter field with the resource request.

    "eventData": {
      "filter": <query>
    }
    
  • Get

    Contains an identifier of the received resource.

    "eventData":{
      "identifier": <resource_id>
    }
    
  • Delete

    Contains the deleted resource.

    "eventData": {
      "data": {
        "displayName": <display_name>,
        "description": <description>,
        "filters": [
          ...
        ],
        "id": <resource_id>
      }
    }
    
  • Create

    Contains the created resource.

    "eventData": {
      "data": {
        "data": { ... },
        "name": <created_resource_name>,
        "id": <resource_id>
      }
    }
    
  • Update

    Contains the original and new versions of a resource.

    "stringifiedEventData": {
      "eventType": 7,
      "before": { ... },
      "after": { ... }
      }
    

Event type per feature

  • Coralogix Actions

    Event NameEvent TypeField Type
    actions.orderACTION_EVENT_TYPE_ACTION_ORDERAction
    actions.listLIST_EVENT_TYPE_ACTION_LISTList
    actions.getGET_EVENT_TYPE_ACTION_GETGet
    actions.deleteDELETE_EVENT_TYPE_ACTION_DELETEDelete
    actions.createCREATE_EVENT_TYPE_ACTION_CREATECreate
    actions.updateUPDATE_EVENT_TYPE_ACTION_REPLACEUpdate
  • Alerts

    Event NameEvent TypeField Type
    alert.snoozeACTION_EVENT_TYPE_ALERT_SNOOZEAction
    alerts.listLIST_EVENT_TYPE_ALERTList
    alerts.getGET_EVENT_TYPE_ALERTGet
    alerts.deleteDELETE_EVENT_TYPE_ALERTDelete
    alerts.createCREATE_EVENT_TYPE_ALERTCreate
    alerts.updateUPDATE_EVENT_TYPE_ALERTUpdate
  • Alert Scheduler

    Event NameEvent TypeField Type
    alert_scheduler.listLIST_EVENT_TYPE_ALERT_SCHEDULERList
    alert_scheduler.getGET_EVENT_TYPE_ALERT_SCHEDULERGet
    alert_scheduler.deleteDELETE_EVENT_TYPE_ALERT_SCHEDULERDelete
    alert_scheduler.createCREATE_EVENT_TYPE_ALERT_SCHEDULERCreate
    alert_scheduler.updateUPDATE_EVENT_TYPE_ALERT_SCHEDULERUpdate
  • API Keys

    Event NameEvent TypeField Type
    api-key.getGET_EVENT_TYPE_API_KEYGet
    api-key.deleteDELETE_EVENT_TYPE_API_KEYDelete
    api-key.createCREATE_EVENT_TYPE_API_KEYCreate
    api-key.updateUPDATE_EVENT_TYPE_API_KEYUpdate
    api-keys.listLIST_EVENT_TYPE_API_KEYList
    team-api-keys-security-settings.updateUPDATE_EVENT_TYPE_API_KEY_SECURITY_SETTINGUpdate
  • APM

    Event NameEvent TypeField Type
    apm.entity.actionACTION_EVENT_TYPE_APM_ENTITYAction
    apm.entity.listLIST_EVENT_TYPE_APM_ENTITYList
    apm.entity.getGET_EVENT_TYPE_APM_ENTITYGet
    apm.entity.deleteDELETE_EVENT_TYPE_APM_ENTITYDelete
    apm.entity.createCREATE_EVENT_TYPE_APM_ENTITYCreate
    apm.settings.updateUPDATE_EVENT_TYPE_APM_SETTINGSUpdate
    apm.entity.updateUPDATE_EVENT_TYPE_APM_ENTITYUpdate
  • Archive Setup

    Event NameEvent TypeField Type
    archive-setup.getGET_EVENT_TYPE_ARCHIVE_SETUPGet
    archive-setup.updateUPDATE_EVENT_TYPE_ARCHIVE_SETUPUpdate
  • Cloud Metadata Enrichment

    Event NameEvent TypeField Type
    cloud-metadata-enrichment.deleteDELETE_EVENT_TYPE_CLOUD_METADATA_ENRICHMENTDelete
    cloud-metadata-enrichment.createCREATE_EVENT_TYPE_CLOUD_METADATA_ENRICHMENTCreate
    cloud-metadata-enrichment.updateUPDATE_EVENT_TYPE_CLOUD_METADATA_ENRICHMENTUpdate
  • Continuous Profiling

    Event NameEvent TypeField Type
    profiles.symbols.uploadACTION_EVENT_TYPE_PROFILES_SYMBOLS_UPLOADAction
    profiles.queryACTION_EVENT_TYPE_PROFILES_QUERYAction
    profiles.query.graphACTION_EVENT_TYPE_PROFILES_QUERY_GRAPHAction
  • Custom Enrichment

    Event NameEvent TypeField Type
    custom-enrichment.overwriteACTION_EVENT_TYPE_OVERWRITE_CUSTOM_ENRICHMENTSAction
    custom-enrichment.deleteDELETE_EVENT_TYPE_CUSTOM_ENRICHMENTDelete
    custom-enrichment.createCREATE_EVENT_TYPE_CUSTOM_ENRICHMENTCreate
    custom-enrichment.updateUPDATE_EVENT_TYPE_CUSTOM_ENRICHMENTUpdate
    custom-enrichment-data.listLIST_EVENT_TYPE_CUSTOM_ENRICHMENT_DATAList
    custom-enrichment-data.getGET_EVENT_TYPE_CUSTOM_ENRICHMENT_DATAGet
    custom-enrichment-data.deleteDELETE_EVENT_TYPE_CUSTOM_ENRICHMENT_DATADelete
    custom-enrichment-data.createCREATE_EVENT_TYPE_CUSTOM_ENRICHMENT_DATACreate
    custom-enrichment-data.updateUPDATE_EVENT_TYPE_CUSTOM_ENRICHMENT_DATAUpdate
  • Dashboard Reports

    Event NameEvent TypeField Type
    dashboard-report.getGET_EVENT_TYPE_DASHBOARD_REPORTGet
    dashboard-report-schedule.listLIST_EVENT_TYPE_DASHBOARD_REPORT_SCHEDULEList
    dashboard-report-schedule.getGET_EVENT_TYPE_DASHBOARD_REPORT_SCHEDULEGet
    dashboard-report-schedule.deleteDELETE_EVENT_TYPE_DASHBOARD_REPORT_SCHEDULEDelete
    dashboard-report-schedule.createCREATE_EVENT_TYPE_DASHBOARD_REPORT_SCHEDULECreate
    dashboard-report-schedule.updateUPDATE_EVENT_TYPE_DASHBOARD_REPORT_SCHEDULEUpdate
  • Dashboards

    Event NameEvent TypeField Type
    dashboards.listLIST_EVENT_TYPE_DASHBOARDList
    dashboards.getGET_EVENT_TYPE_DASHBOARDGet
    dashboards.deleteDELETE_EVENT_TYPE_DASHBOARDDelete
    dashboards.createCREATE_EVENT_TYPE_DASHBOARDCreate
    dashboards.updateUPDATE_EVENT_TYPE_DASHBOARDUpdate
  • Data Usage

    Event NameEvent TypeField Type
    datausage.get-dailyACTION_EVENT_TYPE_GET_DAILY_DATA_USAGEAction
    datausage.exportACTION_EVENT_TYPE_EXPORT_DETAILED_DATA_USAGEAction
    datausage.data-usage-to-metrics-enableACTION_EVENT_TYPE_DATA_USAGE_TO_METRICS_ENABLEAction
  • Enrichment

    Event NameEvent TypeField Type
    enrichment.listLIST_EVENT_TYPE_ENRICHMENTList
    enrichment.getGET_EVENT_TYPE_ENRICHMENTGet
  • Events2Metrics

    events-2-metrics.listLIST_EVENT_TYPE_EVENTS_2_METRICSList
    events-2-metrics.getGET_EVENT_TYPE_EVENTS_2_METRICSGet
    events-2-metrics.deleteDELETE_EVENT_TYPE_EVENTS_2_METRICSDelete
    events-2-metrics.createCREATE_EVENT_TYPE_EVENTS_2_METRICSCreate
    events-2-metrics.updateUPDATE_EVENT_TYPE_EVENTS_2_METRICSUpdate
  • Extensions

    Event NameEvent TypeField Type
    extensions.undeployACTION_EVENT_TYPE_EXTENSION_UNDEPLOYAction
    extensions.updateACTION_EVENT_TYPE_EXTENSION_UPDATEAction
    extensions.deployACTION_EVENT_TYPE_EXTENSION_DEPLOYAction
    extensions.listLIST_EVENT_TYPE_EXTENSIONList
    extensions.getGET_EVENT_TYPE_EXTENSIONGet
  • Forwarders

    Event NameEvent TypeField Type
    forwarders.testACTION_EVENT_TYPE_FORWARDERS_TESTAction
    forwarders.listLIST_EVENT_TYPE_FORWARDERSList
    forwarders.getGET_EVENT_TYPE_FORWARDERSGet
    forwarders.deleteDELETE_EVENT_TYPE_FORWARDERSDelete
    forwarders.createCREATE_EVENT_TYPE_FORWARDERSCreate
    forwarders.updateUPDATE_EVENT_TYPE_FORWARDERSUpdate
  • Geo Enrichment

    Event NameEvent TypeField Type
    geo-enrichment.deleteDELETE_EVENT_TYPE_GEO_ENRICHMENTDelete
    geo-enrichment.createCREATE_EVENT_TYPE_GEO_ENRICHMENTCreate
    geo-enrichment.updateUPDATE_EVENT_TYPE_GEO_ENRICHMENTUpdate
  • Group

    Event NameEvent TypeField Type
    group.deleteDELETE_EVENT_TYPE_GROUPDelete
    group.createCREATE_EVENT_TYPE_GROUPCreate
    group.updateUPDATE_EVENT_TYPE_GROUPUpdate
  • Incidents

    Event NameEvent TypeField Type
    incidents.closeACTION_EVENT_TYPE_INCIDENTS_CLOSEAction
    incidents.assignACTION_EVENT_TYPE_INCIDENTS_ASSIGNAction
    incidents.unassignACTION_EVENT_TYPE_INCIDENTS_UNASSIGNAction
    incidents.acknowledgeACTION_EVENT_TYPE_INCIDENTS_ACKNOWLEDGEAction
    incidents.listLIST_EVENT_TYPE_INCIDENTSList
    incidents.getGET_EVENT_TYPE_INCIDENTSGet
  • Livetail

    Event NameEvent TypeField Type
    livetail.subscribeACTION_EVENT_TYPE_LIVETAIL_SUBSCRIBEAction
  • Logs TCO

    Event NameEvent TypeField Type
    logs.tco.testACTION_EVENT_TYPE_LOGS_TCO_TESTAction
    logs.tco.orderACTION_EVENT_TYPE_LOGS_TCO_ORDERAction
    logs.tco.listLIST_EVENT_TYPE_LOGS_TCOList
    logs.tco.getGET_EVENT_TYPE_LOGS_TCOGet
    logs.tco.deleteDELETE_EVENT_TYPE_LOGS_TCODelete
    logs.tco.createCREATE_EVENT_TYPE_LOGS_TCOCreate
    logs.tco.updateUPDATE_EVENT_TYPE_LOGS_TCOUpdate
  • Logs Parsing Rules

    Event NameEvent TypeField Type
    logs.parsing-rules.orderACTION_EVENT_TYPE_LOGS_RULES_GROPS_ORDERAction
    logs.parsing-rules.listLIST_EVENT_TYPE_LOGS_RULES_GROUPList
    logs.parsing-rules.getGET_EVENT_TYPE_LOGS_RULES_GROUPGet
    logs.parsing-rules.deleteDELETE_EVENT_TYPE_LOGS_RULES_GROUPDelete
    logs.parsing-rules.createCREATE_EVENT_TYPE_LOGS_RULES_GROUPCreate
    logs.parsing-rules.updateUPDATE_EVENT_TYPE_LOGS_RULES_GROUPUpdate
  • Logs Data API

    Event NameEvent TypeField Type
    logs-data-api.ReadDataACTION_EVENT_TYPE_DATA_API_READ_DATAAction
  • Metrics

    Event NameEvent TypeField Type
    metrics.data-api.readACTION_EVENT_TYPE_METRICS_READ_DATAAction
  • Notification Center Presets

    Event NameEvent TypeField Type
    notification-center-preset.set-as-defaultACTION_EVENT_TYPE_NOTIFICATION_CENTER_PRESET_SET_AS_DEFAULTAction
    notification-center-preset.deleteDELETE_EVENT_TYPE_NOTIFICATION_CENTER_PRESETDelete
    notification-center-preset.createCREATE_EVENT_TYPE_NOTIFICATION_CENTER_PRESETCreate
    notification-center-preset.updateUPDATE_EVENT_TYPE_NOTIFICATION_CENTER_PRESETUpdate
  • Organization

    Event NameEvent TypeField Type
    organization.add-domainACTION_EVENT_TYPE_ADD_DOMAINAction
    organization.move-quotaACTION_EVENT_TYPE_MOVE_QUOTAAction
    organization.settings.getGET_EVENT_TYPE_ORGANIZATION_SETTINGSGet
    organization.settings.updateUPDATE_EVENT_TYPE_ORGANIZATION_SETTINGSUpdate
    organization.updateUPDATE_EVENT_TYPE_ORGANIZATIONUpdate
  • Webhooks

    Event NameEvent TypeField Type
    outbound-webhook-types.listLIST_EVENT_TYPE_OUTBOUND_WEBHOOK_TYPESList
    outbound-webhooks.testACTION_EVENT_TYPE_OUTBOUND_WEBHOOK_TESTAction
    outbound-webhooks.list-ibm-ens-instancesACTION_EVENT_TYPE_OUTBOUND_WEBHOOK_LIST_IMB_ENS_INSTANCESAction
    outbound-webhooks.listLIST_EVENT_TYPE_OUTBOUND_WEBHOOKList
    outbound-webhooks.getGET_EVENT_TYPE_OUTBOUND_WEBHOOKGet
    outbound-webhooks.deleteDELETE_EVENT_TYPE_OUTBOUND_WEBHOOKDelete
    outbound-webhooks.createCREATE_EVENT_TYPE_OUTBOUND_WEBHOOKCreate
    outbound-webhooks.updateUPDATE_EVENT_TYPE_OUTBOUND_WEBHOOKUpdate
  • Recording Rules

    Event NameEvent TypeField Type
    recording-rule.deleteDELETE_EVENT_TYPE_RECORDING_RULEDelete
    recording-rule.createCREATE_EVENT_TYPE_RECORDING_RULECreate
    recording-rule.updateUPDATE_EVENT_TYPE_RECORDING_RULEUpdate
    recording-rule-group.deleteDELETE_EVENT_TYPE_RECORDING_RULE_GROUPDelete
    recording-rule-group.createCREATE_EVENT_TYPE_RECORDING_RULE_GROUPCreate
    recording-rule-group.updateUPDATE_EVENT_TYPE_RECORDING_RULE_GROUPUpdate
    recording-rule-group-set.deleteDELETE_EVENT_TYPE_RECORDING_RULE_GROUP_SETDelete
    recording-rule-group-set.createCREATE_EVENT_TYPE_RECORDING_RULE_GROUP_SETCreate
    recording-rule-group-set.updateUPDATE_EVENT_TYPE_RECORDING_RULE_GROUP_SETUpdate
  • Roles

    Event NameEvent TypeField Type
    role.listLIST_EVENT_TYPE_ROLEList
    role.getGET_EVENT_TYPE_ROLEGet
    role.deleteDELETE_EVENT_TYPE_ROLEDelete
    role.createCREATE_EVENT_TYPE_ROLECreate
    role.updateUPDATE_EVENT_TYPE_ROLEUpdate
  • RUM

    • RUM settings

      Event NameEvent TypeField Type
      rum-settings.getGET_EVENT_TYPE_RUM_SETTINGSGet
      rum-settings.updateUPDATE_EVENT_TYPE_RUM_SETTINGSUpdate
    • SDK versions

      Event NameEvent TypeField Type
      sdk-version.getGET_EVENT_TYPE_SDK_VERSIONGet
    • Session Recording

      Event NameEvent TypeField Type
      session-recording.getGET_EVENT_TYPE_SESSION_RECORDINGGet
    • Source Map

      Event NameEvent TypeField Type
      source-map.getGET_EVENT_TYPE_SOURCE_MAPGet
    • Hide Errors

      Event NameEvent TypeField Type
      hide-errors.listLIST_EVENT_TYPE_HIDE_ERRORSList
      hide-errors.getGET_EVENT_TYPE_HIDE_ERRORSGet
      hide-errors.deleteDELETE_EVENT_TYPE_HIDE_ERRORSDelete
      hide-errors.createCREATE_EVENT_TYPE_HIDE_ERRORSCreate
      hide-errors.updateUPDATE_EVENT_TYPE_HIDE_ERRORSUpdate
    • Saved Filters

      Event NameEvent TypeField Type
      saved-filter.listLIST_EVENT_TYPE_SAVED_FILTERList
      saved-filter.getGET_EVENT_TYPE_SAVED_FILTERGet
      saved-filter.deleteDELETE_EVENT_TYPE_SAVED_FILTERDelete
      saved-filter.createCREATE_EVENT_TYPE_SAVED_FILTERCreate
      saved-filter.updateUPDATE_EVENT_TYPE_SAVED_FILTERUpdate
  • SCIM

    Event NameEvent TypeField Type
    scim.user.deleteACTION_EVENT_TYPE_SCIM_DELETE_USERAction
    scim.group.replaceACTION_EVENT_TYPE_SCIM_REPLACE_GROUPAction
    scim.user.createACTION_EVENT_TYPE_SCIM_CREATE_USERAction
    scim.user.replaceACTION_EVENT_TYPE_SCIM_REPLACE_USERAction
    scim.user.updateACTION_EVENT_TYPE_SCIM_UPDATE_USERAction
    scim.group.deleteACTION_EVENT_TYPE_SCIM_DELETE_GROUPAction
    scim.group.updateACTION_EVENT_TYPE_SCIM_UPDATE_GROUPAction
    scim.group.createACTION_EVENT_TYPE_SCIM_CREATE_GROUPAction
    scim.user.listLIST_EVENT_SCIM_USERList
    scim.group.listLIST_EVENT_SCIM_GROUPList
    scim.schema.listLIST_EVENT_SCIM_SCHEMAList
    scim.schema.getGET_EVENT_SCIM_SCHEMAGet
    scim.user.getGET_EVENT_SCIM_USERGet
    scim.group.getGET_EVENT_SCIM_GROUPGet
  • Scopes

    Event NameEvent TypeField Type
    scopes.listLIST_EVENT_TYPE_SCOPE_LISTList
    scopes.getGET_EVENT_TYPE_SCOPE_GETGet
    scopes.deleteDELETE_EVENT_TYPE_SCOPE_DELETEDelete
    scopes.createCREATE_EVENT_TYPE_SCOPE_CREATECreate
    scopes.updateUPDATE_EVENT_TYPE_SCOPE_UPDATEUpdate
  • Security Enrichments

    Event NameEvent TypeField Type
    security-enrichment.deleteDELETE_EVENT_TYPE_SECURITY_ENRICHMENTDelete
    security-enrichment.createCREATE_EVENT_TYPE_SECURITY_ENRICHMENTCreate
    security-enrichment.updateUPDATE_EVENT_TYPE_SECURITY_ENRICHMENTUpdate
  • Spans TCO

    Event NameEvent TypeField Type
    spans.tco.orderACTION_EVENT_TYPE_SPANS_TCO_ORDERAction
    spans.tco.listLIST_EVENT_TYPE_SPANS_TCOList
    spans.tco.getGET_EVENT_TYPE_SPANS_TCOGet
    spans.tco.deleteDELETE_EVENT_TYPE_SPANS_TCODelete
    spans.tco.createCREATE_EVENT_TYPE_SPANS_TCOCreate
    spans.tco.updateUPDATE_EVENT_TYPE_SPANS_TCOUpdate
  • SSO

    Event NameEvent TypeField Type
    sso.set-idp-parametersACTION_EVENT_TYPE_SSO_SET_IDP_PARAMETERSAction
    sso.set-activeACTION_EVENT_TYPE_SSO_SET_ACTIVEAction
    sso.configuration.getGET_EVENT_SSO_CONFIGURATIONGet
    sso.sp-parameters.getGET_EVENT_SSO_SP_PARAMETERSGet
  • Team IP Access

    Event NameEvent TypeField Type
    team-ip-access.listLIST_EVENT_TYPE_IP_FILTERList
    team-ip-access.deleteDELETE_EVENT_TYPE_IP_FILTERDelete
    team-ip-access.createCREATE_EVENT_TYPE_IP_FILTERCreate
    team-ip-access.updateUPDATE_EVENT_TYPE_IP_FILTERUpdate
  • Team Management

    Event NameEvent TypeField Type
    team-landing-page.updateUPDATE_EVENT_TYPE_TEAM_LANDING_PAGEUpdate
    team-member.removeACTION_EVENT_TYPE_TEAM_MEMBER_REMOVEAction
    team-member.unlockACTION_EVENT_TYPE_TEAM_MEMBER_UNLOCKAction
    team-member.addACTION_EVENT_TYPE_TEAM_MEMBER_ADDAction
    team-member.inviteACTION_EVENT_TYPE_TEAM_MEMBER_INVITEAction
    team-member.listLIST_EVENT_TEAM_MEMBERList
    team-sessions.session-timeout.updateUPDATE_EVENT_TYPE_TEAM_SESSIONS_SESSION_TIMEOUTUpdate
    team-sessions.force-logout.updateUPDATE_EVENT_TYPE_TEAM_SESSIONS_FORCE_LOGOUTUpdate
    team-url.updateUPDATE_EVENT_TYPE_TEAM_URLUpdate
  • Templates

    Event NameEvent TypeField Type
    templates.list.readACTION_EVENT_TYPE_TEMPLATES_READ_DATAAction
    templates.count.readACTION_EVENT_TYPE_TEMPLATES_COUNT_READ_DATAAction
    templates-dates.getGET_EVENT_TYPE_TEMPLATES_DATESGet
  • User Management

    Event NameEvent TypeField Type
    user-landing-page.updateUPDATE_EVENT_TYPE_USER_LANDING_PAGEUpdate
    user-settings.getGET_EVENT_TYPE_USER_SETTINGGet
    user-settings.updateUPDATE_EVENT_TYPE_USER_SETTINGUpdate
  • Version Benchmarks

    Event NameEvent TypeField Type
    version-benchmarks.listLIST_EVENT_TYPE_VERSION_BENCHMARKSList
    version-benchmarks.getGET_EVENT_TYPE_VERSION_BENCHMARKSGet
    version-benchmarks.deleteDELETE_EVENT_TYPE_VERSION_BENCHMARKSDelete
    version-benchmarks.createCREATE_EVENT_TYPE_VERSION_BENCHMARKSCreate
    version-benchmarks.updateUPDATE_EVENT_TYPE_VERSION_BENCHMARKSUpdate
  • Views

    Event NameEvent TypeField Type
    view.listLIST_EVENT_TYPE_VIEWList
    view.getGET_EVENT_TYPE_VIEWGet
    view.deleteDELETE_EVENT_TYPE_VIEWDelete
    view.createCREATE_EVENT_TYPE_VIEWCreate
    view.updateUPDATE_EVENT_TYPE_VIEWUpdate
    • View Folder

      Event NameEvent TypeField Type
      view-folder.listLIST_EVENT_TYPE_VIEW_FOLDERList
      view-folder.getGET_EVENT_TYPE_VIEW_FOLDERGet
      view-folder.deleteDELETE_EVENT_TYPE_VIEW_FOLDERDelete
      view-folder.createCREATE_EVENT_TYPE_VIEW_FOLDERCreate
      view-folder.updateUPDATE_EVENT_TYPE_VIEW_FOLDERUpdate

Monitoring audit events

To monitor your audit events, take the following steps:

STEP 1. Sign in to the team designated as your audit team.

STEP 2. View audit events in Explore or Visual Explorer or by creating visualizations in Custom Dashboards.

Monitor & query audit events in Explore

Your audit events will appear in the Logs screen in Explore. For any log, click on the left-hand ellipsis and select Show graph for key from the dropdown menu.

auditv2_explore.png

This graph shows the breakdown of actions taken on the organization, team, and user levels for actorType.

Let’s say an admin is interested in querying users with the most actions taken, grouped by user name and team name. The DataPrime query will look as follows:

source logs | filter actorDetails.username != null | filter actorDetails.teamName != null | groupby $d.actorDetails.username as username, actorDetails.teamName as team_name agg count() as count

Create analytics in Custom Dashboards

Create a visual in Custom Dashboards to view audit event analytics.

auditv2_analytics1.png

In this example, the user has created a pie chart to understand the breakdown of events per Coralogix environment. Here you can see the user query failure errors per Coralogix event.

auditv2_analytics2.png

Audit v1 (Legacy)

Existing users are strongly encouraged to migrate from Audit v1 to v2.

Audit v1 users can track actions based on action_details.operation.action; for example, by using the following query: action_details.operation.action:"POST:/api/v1/user/login".

The following is the list of the most common actions which include action_details.operation.operation_payload key:
POST:/api/v1/logquery/savedSave log query
POST:/api/v1/logsparser/rules/groupRules - New parsing rule group
POST:/api/v1/logsparser/groups/reorderRules - Rule groups reorder
POST:/api/v1/archiveprovidersArchive - Configure S3 Archive bucket
POST:/api/v1/archiveproviders/editArchive - Edit S3 Archive bucket configuration
POST:/api/v1/inviteInvites - An invitation sent
POST:/api/v1/invite/request/approveInvites - A user was approved
POST:/api/v1/invite/request/declineInvites - A user was declined
POST:/api/v1/user/forgotpassword/:keyPassword - Changes the password from the forgot password email
POST:/api/v1/user/forgotpasswordPassword - Send forgot password email
POST:/api/v1/user/changepasswordPassword - Change password
POST:/api/v1/user/team/switchLog out / switch team
POST:/api/v1/companies/:companyId/rbac/groupsGroups - Get all RBAC groups
POST:/api/v1/companies/:companyId/rbac/groups/:groupId/rolesGroups - Add RBAC group role for group
POST:/api/v1/rbac/:companyId/users/:userId/removeFromGroupGroups - Remove user from RBAC group
POST:/api/v1/rbac/:companyId/users/:userId/moveToGroupGroups - Move user to different RBAC group
POST:/api/v1/rbac/:companyId/users/:userId/addToGroupGroups - Add user to RBAC group
POST:/api/v1/rbac/:companyId/users/:userId/addUserToGroupsGroups - Add user to RBAC groups
POST:/api/v1/rbac/:companyId/users/:userId/removeUserFromGroupsGroups - Remove user to RBAC groups
POST:/api/v1/company/saml/metadataSAML - Update SAML metadata
PUT:/api/v1/company/samlSAML - Get company SAML configuration
POST:/api/v1/alert/:id/snoozeAlerts - Snooze alert
POST:/api/v1/alert/snoozedAlerts - Get all snoozed alert
POST:/api/v1/customenrichments/getUploadUrlCustom Enrichment - Upload custom enrichment csv
POST:/api/v1/cloudsecurity/installCloud Security - Installation
POST:/api/v1/cloudsecurity/getstatusCloud Security - Get installation status
POST:/api/v1/rulesapi/crud/rulesetRules - Create rule-set
PUT:/api/v1/rulesapi/ruleset/reorderRules - Reorder rule set
POST:/api/v1/archivequeriesArchive query - New archive query
POST:/api/v1/archivequeries/:id/reindexArchive query - Create new archive query reindex
POST:/api/v1/archivequeries/:id/reindex/:reindexId/queryArchive query - Cache reindex query
POST:/api/v1/quota-policiesTCO Optimizer - Create quota policy
PUT:/api/v1/quota-policies/reorderTCO Optimizer - Reorder quota policies
PUT:/api/v1/quota-policies/:idTCO Optimizer - Update quota policy
PUT:/api/v1/quota-policies/toggle/:idTCO Optimizer - Toggle quota policy
PUT:/api/v1/quota-overridesTCO Optimizer - Create quota override
POST:/api/v1/external/alertsAlerts - Add new alert
POST:/api/v1/external/alerts/bulkAlerts - Add new alerts
PUT:/api/v1/external/alertsAlerts - Update alert
POST:/api/v1/external/groupRules - Create rule parsing group
PUT:/api/v1/external/group/:parsingThemeIdRules - Update rule parsing group
PUT:/api/v1/external/group/toggle/:parsingThemeIdRules -  Toggle rule parsing group
POST:/api/v1/external/rule/:parsingThemeIdRules - Add parsing rule to parsing group
PUT:/api/v1/external/rule/:ruleId/group/:parsingThemeIdRules - Update parsing rule
POST:/api/v1/external/rules/exportRules - Export rules
POST:/api/v1/external/actions/ruleRules - Add parsing rule group
PUT:/api/v1/external/actions/rule/:groupIdRules - Update parsing rule group
POST:/api/v1/external/action/rule/:groupIdRules - Create parsing rule group
PUT:/api/v1/external/action/:ruleId/rule/:groupIdRules - Update parsing rule
PUT:/api/v1/external/customenrichments/:customEnrichmentIdCustom Enrichment - Update custom enrichment
POST:/api/v1/external/tagsTags - Get new tag
POST:/api/v1/external/bitbucketTags - Get new Bitbucket tag
POST:/api/v1/external/tfsTags - Get new tfs tag
POST:/api/v1/external/gitlabTags - Get new Gitlab tag
POST:/api/v1/external/tco/policiesTCO Optimizer - Create new policy
PUT:/api/v1/external/tco/policies/reorderTCO Optimizer - Reorder policies
PUT:/api/v1/external/tco/policies/:idTCO Optimizer - Update policy
PUT:/api/v1/external/tco/policies/:id/toggleTCO Optimizer - Toggle policy
POST:/api/v1/external/tco/overridesTCO Optimizer - Add new TCO override
POST:/api/v1/external/tco/overrides/bulkTCO Optimizer - Add new TCO overrides
POST:/api/v1/user/settings/es_api_keyAPI Access - Generate new Logs Query Key for user
POST:/api/v1/user/settings/teams_api_keyAPI Access - Generate new Teams API Key for user
POST:/api/v1/payment/subscriberPlan - Subscribe to payment
POST:/api/v1/payment/unsubscribePlan - Unsubscribe to payment
POST:/api/v1/payment/changePlanPlan - Change payment plan