Atlassian Audit Logs

Atlassian audit logs allow you to view the audit events that have occurred in your Atlassian organization. To view more info about audit logs including what types of events are tracked you can view more info on the Atlassian docs

In order to ingest your Atlassian audit logs, you must be an Atlassian Access customer. To see if you already have access navigate to your Atlassian admin panel https://admin.atlassian.com and go to Security -> Audit Log. From there if you have access you will see your events otherwise you will see a link to signup for access.

atlassian-1

RunReveal will backfill your audit logs to the last 7 days of events. Once the processor has caught up, RunReveal will import new audit logs roughly every 60 seconds.

Setup

Give your Atlassian source a descriptive name to help find it later. The two fields we require from your Atlassian account are your Organization ID and an API Key.

Atlassian API Key

Create an API Key in Atlassian to give RunReveal access to your audit logs. From your Atlassian admin panel, navigate to Settings -> API keys. From here you can create a new API key.

atlassian-2

Give the new key a name and choose an expiration date. Atlassian allows date no further than 1 year in the future. Copy the Organization ID and the API key fields to your RunReveal source.

Make sure to generate a new API key before the expiration date and update RunReveal with the new key to continue receiving events without disruption.

atlassian-3

Verify Its working

Once added the source logs should begin flowing within a minute.

You can validate we are receiving your logs by running the following SQL query.

SELECT * FROM runreveal.logs WHERE sourceType = 'atlassian' LIMIT 1

Schema

The following columns are exposed for this source. RunReveal applies schema normalization across all sources, ensuring uniform field names and data types for cross-source queries and reusable detection logic.

Table: atlassian_logs (59 columns)

ColumnType
workspaceIDString
sourceIDString
sourceTypeLowCardinality(String)
sourceTTLUInt32
receivedAtDateTime
idString
eventTimeDateTime
eventNameString
eventIDString
srcIPString
srcASCountryCodeString
srcASNumberUInt32
srcASOrganizationString
srcCityString
srcConnectionTypeString
srcISPString
srcLatitudeFloat64
srcLongitudeFloat64
srcUserTypeString
dstIPString
dstASCountryCodeString
dstASNumberUInt32
dstASOrganizationString
dstCityString
dstConnectionTypeString
dstISPString
dstLatitudeFloat64
dstLongitudeFloat64
dstUserTypeString
actorMap(String, String)
ColumnType
tagsMap(String, String)
resourcesArray(String)
serviceNameString
readOnlyBool
rawLogString
typeString
actionString
actor_idString
actor_nameString
actor_emailString
auth_typeString
token_idString
token_labelString
actor_selfString
context_idString
context_typeString
context_selfString
context_altString
container_idString
container_typeString
container_selfString
container_altString
location_ipString
country_nameString
region_nameString
cityString
self_linkString
message_contentString
message_formatString