Identity Azure RBAC premium

Log Analytics Data Reader

A Log Analytics Data Reader assignment is the access role you use when someone needs to read log data, not manage the workspace. It lets a security analyst, developer, auditor, or automation identity query approved Log Analytics data while keeping workspace settings, table retention, diagnostic routing, and data collection configuration protected. In plain terms, it separates evidence access from administration. That matters because logs often contain operational clues, customer identifiers, IP addresses, error payloads, and security events that should be searchable by the right people only.

Aliases
No aliases mapped yet
Difficulty
fundamentals
CLI mappings
4
Last verified
2026-05-16

Microsoft Learn

A Log Analytics Data Reader assignment is an Azure built-in RBAC role for letting approved users, groups, or workload identities query the Log Analytics logs they are allowed to view across workspaces and tables without granting workspace administration, table management, or broader monitoring control.

Microsoft Learn: Azure built-in roles for Monitor2026-05-16

Technical context

Technically, a Log Analytics Data Reader assignment sits in Azure RBAC and Azure Monitor Logs. It is assigned to a Microsoft Entra principal at a scope such as subscription, resource group, workspace, or a more granular monitored-resource boundary. The role is evaluated by the control plane before Log Analytics queries read data from workspace tables. It works alongside Monitoring Reader, Reader, diagnostic settings, table-level access rules, KQL, Microsoft Sentinel, and Azure Policy. Operators should always verify the assignment scope, inherited roles, principal type, and whether resource-context or workspace-context access is expected.

Why it matters

A Log Analytics Data Reader assignment matters because monitoring data is both operational evidence and sensitive data. Without a focused reader role, teams often overgrant Contributor or workspace administrator access just so someone can run a query during an outage or audit. That weakens least privilege and makes it harder to explain who could see which logs. With the right assignment, developers can investigate failed releases, security teams can search events, and auditors can review evidence without changing retention, ingestion, tables, or data collection rules. It also gives platform teams a cleaner way to support resource-context access where only logs related to approved resources should be visible.

Where you see it

Signals, screens, and Azure surfaces where this term usually becomes operational.

Signal 01

In the workspace IAM view, this role appears on analyst groups, auditors, or managed identities that need query-only access without workspace administration permissions during release review, incident triage, and ownership checks.

Signal 02

In Azure Monitor Logs or Sentinel, denied KQL queries or missing table results often reveal that the reader role is scoped incorrectly during release review, incident triage, and ownership checks.

Signal 03

In access reviews, operators export role assignments, group membership, and sample KQL evidence to prove analysts can read logs without changing settings during release review, incident triage, and ownership checks.

When this becomes relevant

Specific situations where this term helps solve real Azure design, operations, migration, security, reliability, cost, or governance problems.

  • Grant security analysts query access to workspace logs without allowing them to change retention, tables, or diagnostic settings.
  • Give developers temporary incident evidence access while keeping production monitoring configuration under platform ownership.
  • Authorize a managed identity to run approved log queries for automation, compliance reporting, or workbook validation.
  • Support granular Log Analytics access reviews by comparing role assignments, table visibility, and inherited RBAC scope.

Real-world case studies

Different enterprise-style examples that show the term being used to hit measurable objectives.

Case study 01

Securing audit access to production logs

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

NorthLake Health, a regional healthcare provider, needed outside auditors to review access logs for patient-portal incidents without allowing changes to Log Analytics workspace settings.

Business/Technical Objectives
  • Provide auditors read access within two business days.
  • Avoid granting Contributor or workspace administrator permissions.
  • Keep protected health information exposure limited to approved tables.
  • Produce evidence that access was removed after the review.
Solution Using Log Analytics Data Reader

The cloud platform team assigned Log Analytics Data Reader to a temporary Microsoft Entra audit group at the patient-portal workspace scope. They verified the role definition with Azure CLI, listed inherited assignments, and tested a time-bounded KQL query against approved tables only. Security added Privileged Identity Management approval for the group, while Azure Policy kept diagnostic settings and retention under platform ownership. The team documented the workspace ID, scope string, role assignment ID, sample query, and cleanup command in the audit runbook. Microsoft Sentinel analysts kept their separate operational roles, so audit access did not blur incident-response responsibilities. They also recorded reviewer names, approved query samples, and expiry dates in the compliance evidence workbook.

Results & Business Impact
  • Audit onboarding time dropped from six days to one day.
  • No workspace settings or retention policies were exposed to auditors.
  • Access review evidence showed zero lingering assignments after closeout.
  • The same access pattern was reused for three compliance reviews.
Key Takeaway for Glossary Readers

Log Analytics Data Reader gives auditors and responders the evidence they need while keeping monitoring administration under tighter control.

Case study 02

Giving developers safe incident evidence

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

Fabrikam Market, an online retailer, had developers waiting on operations staff to copy log snippets during checkout incidents because production workspace access was too broad to grant safely.

Business/Technical Objectives
  • Let developers query checkout logs during Sev2 incidents.
  • Keep table retention, diagnostic settings, and exports locked down.
  • Reduce mean time to evidence by at least 50%.
  • Record every temporary access grant for post-incident review.
Solution Using Log Analytics Data Reader

The operations team created an incident-only Entra group and assigned Log Analytics Data Reader at the checkout resource group scope. Workbooks and saved KQL queries limited developers to request, dependency, and exception patterns tied to the application. Azure CLI commands exported role assignments before and after each incident, and Privileged Identity Management required approval from the incident commander. The workspace remained owned by the platform team, with Contributor access limited to monitoring engineers. Developers could query evidence directly, but they could not change ingestion, table plans, data collection rules, or alert logic. The incident runbook captured owners, escalation rules, and test queries for every application team.

Results & Business Impact
  • Mean time to first useful log query fell from 42 minutes to 14 minutes.
  • No developers received Contributor access during the pilot quarter.
  • Post-incident reviews included assignment IDs and sample queries.
  • Checkout incident duration improved by 18% across four events.
Key Takeaway for Glossary Readers

A focused log-reader role keeps incident response fast without turning every developer into a monitoring administrator.

Case study 03

Automating compliance queries with managed identity

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

Contoso Trust, a wealth-management firm, ran nightly compliance queries from an automation account and wanted to remove shared credentials from scripts and runbooks.

Business/Technical Objectives
  • Replace stored workspace credentials with Microsoft Entra authentication.
  • Limit automation to query access against compliance tables.
  • Capture nightly evidence for audit without manual export work.
  • Prevent automation from changing workspace configuration.
Solution Using Log Analytics Data Reader

The platform team enabled a user-assigned managed identity for the automation workflow and granted it Log Analytics Data Reader on the compliance workspace. KQL queries were stored in source control, and each run wrote the query time range, workspace ID, and result summary to a secure storage account. Operators used Azure CLI to list the identity assignment and confirm no broader Reader or Contributor roles were inherited. The Log Analytics workspace kept separate owners for retention and diagnostic routing, while the automation identity had only the access needed to query approved evidence. The runbook also named Log Analytics Data Reader ownership, rollback evidence, and validation checks so support could repeat the pattern safely. The automation account kept its assignment evidence with the quarterly SOX control package.

Results & Business Impact
  • Shared workspace credentials were removed from five runbooks.
  • Nightly evidence collection succeeded 99.5% of the time over 90 days.
  • Quarterly access review time dropped by 30%.
  • No configuration-changing permissions were assigned to the automation identity.
Key Takeaway for Glossary Readers

Log Analytics Data Reader pairs well with managed identity when automation needs evidence, not administrative power.

Why use Azure CLI for this?

Azure CLI is useful for a Log Analytics Data Reader assignment because access reviews need repeatable evidence. Commands can list role assignments, resolve scopes, inspect groups, and confirm whether query-only identities have the intended workspace access.

CLI use cases

  • List current assignments at the workspace or resource scope before approving query access for a new analyst.
  • Inspect the built-in role definition so reviewers know the assignment is query-focused, not administrative.
  • Create a narrowly scoped assignment for a managed identity that runs approved monitoring or compliance queries.
  • Remove temporary access after an incident and keep the assignment identifier in the closeout record.

Before you run CLI

  • Confirm the active tenant and subscription because a valid principal in the wrong tenant can make the access review meaningless.
  • Copy the exact workspace, resource group, subscription, or resource scope where log visibility should begin and end.
  • Identify whether the assignee is a user, group, service principal, or managed identity before creating or deleting assignments.
  • Use list and definition commands first; role assignment create or delete changes production access and needs approval.

What output tells you

  • Role assignment output shows the principal, role name, scope, and assignment ID that explain who can query which log boundary.
  • Inherited assignment output reveals when access is coming from a subscription or resource group rather than the workspace itself.
  • Role definition output helps reviewers distinguish Log Analytics query rights from broad Reader or Contributor permissions.
  • Delete output or absence from the list confirms access cleanup, but operators should still test a harmless query afterward.

Mapped Azure CLI commands

Role assignments for log query access

Direct
Az role definition list --name "Log Analytics Data Reader"
az role definitiondiscoverIdentity
Az role assignment list --scope <workspace-or-resource-scope> --include-inherited --output table
az role assignmentdiscoverIdentity
Az role assignment create --assignee <principal-id> --role "Log Analytics Data Reader" --scope <workspace-or-resource-scope>
az role assignmentsecureIdentity
Az role assignment delete --assignee <principal-id> --role "Log Analytics Data Reader" --scope <workspace-or-resource-scope>
az role assignmentremoveIdentity

Architecture context

Log Analytics Data Reader connects to Identity architecture through scope, identity, data flow, monitoring, cost, and operational ownership. Treat it as a production design checkpoint: verify the Azure resource, the caller, the dependency path, the monitoring signal, and the rollback evidence before changing it.

Security

Security is the main point of Log Analytics Data Reader. The role should be granted only to principals that need query access, and the assignment scope should be as narrow as the work allows. Workspace logs can include user identifiers, source IP addresses, request URLs, exception text, deployment details, and security alerts. Treat the role as access to evidence, not a harmless viewer label. Review inherited assignments, group membership, Privileged Identity Management activation, cross-tenant guests, and any table-level access approach before granting it. When the workflow uses managed identities, pair this role with a documented query purpose, diagnostic setting ownership, and data classification review.

Cost

Cost impact is mostly indirect. The role itself has no SKU price, but better access design can prevent expensive operational habits. Overgranted administrators may change retention, table plans, diagnostic settings, exports, or data collection rules while trying to solve simple query-access problems. Undergranted analysts may open tickets, duplicate workspaces, reroute logs, or ask teams to export data manually. Log Analytics Data Reader keeps the normal path cheaper by letting people query existing data without expanding control-plane permissions. FinOps teams should still watch query volume, workbook usage, retained data, and support effort because investigation patterns can increase ingestion, retention, and engineering time.

Reliability

Reliability impact is indirect but real. During incidents, responders need fast access to the right logs, and blocked queries can extend outage duration. Overbroad access, however, can lead to accidental changes if teams grant higher roles just to bypass query failures. Use Log Analytics Data Reader to keep the incident path predictable: analysts can query, administrators can manage, and automation identities can collect evidence without changing workspace settings. Reliability also depends on assignment scope matching how logs are queried. A resource-context query, Sentinel investigation, workbook, or alert validation may fail if the principal can see the resource but not the workspace data behind it.

Performance

Performance impact is also indirect. Log Analytics Data Reader does not make KQL faster, but it controls who can run queries and which data they can reach. Poorly scoped access can force analysts into broad workspace queries, while well-planned resource-context access can narrow investigations to relevant tables and time ranges. Operators should teach readers to use time filters, table selection, projections, and summarized queries instead of unlimited searches. During an incident, many users repeatedly running expensive queries can increase contention and slow investigation. Good RBAC, workbook design, query hygiene, and clear ownership help performance by reducing noisy, unnecessary log exploration.

Operations

Operations teams use Log Analytics Data Reader during onboarding, access reviews, incident response, and audit evidence collection. Good runbooks show the intended scope, principal, reason for access, approval path, and expected query surfaces. Operators should list role assignments, confirm inherited access, test a harmless KQL query, and capture the result in the change or incident record. When access is temporary, document the expiration or Privileged Identity Management process. For production, avoid portal-only evidence. Use CLI output, Azure Activity Log entries, and workspace query tests together so support teams can distinguish an RBAC problem from a missing table, bad query, or ingestion delay.

Common mistakes

  • Granting Contributor just to solve a query failure instead of checking whether Log Analytics Data Reader fits the investigation.
  • Assigning the role at subscription scope when the requester only needs one workspace or one monitored application boundary.
  • Forgetting that group membership, Privileged Identity Management, and inherited assignments can explain access that is not visible locally.
  • Assuming this role fixes missing data when the real issue is diagnostic routing, ingestion delay, retention, or a bad KQL query.