n8n-nodes-azure-log-analytics
v0.1.1
Published
n8n node to query Azure Monitor Log Analytics workspaces using KQL
Maintainers
Readme
n8n-nodes-azure-log-analytics
This is an n8n community node that lets you query Azure Monitor Log Analytics workspaces using KQL (Kusto Query Language).
n8n is a fair-code licensed workflow automation platform.
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
- Execute Query: Run a KQL query against a Log Analytics workspace
Credentials
To use this node, you need to create an Azure AD app registration with access to your Log Analytics workspace.
Setup Steps
Create an App Registration in Azure Active Directory:
- Go to Azure Portal > Azure Active Directory > App registrations > New registration
- Note the Application (client) ID and Directory (tenant) ID
Create a Client Secret:
- In your app registration, go to Certificates & secrets > New client secret
- Copy the secret value immediately (it won't be shown again)
Grant API Permissions:
- In your app registration, go to API permissions > Add a permission
- Select "APIs my organization uses" and search for "Log Analytics API"
- Add the
Data.Readpermission - Grant admin consent if required
Assign Workspace Access:
- Go to your Log Analytics workspace > Access control (IAM)
- Add a role assignment for your app registration
- Assign the Log Analytics Reader role (or a custom role with query permissions)
Credential Fields
| Field | Description | |-------|-------------| | Tenant ID | Your Azure AD Directory (tenant) ID | | Client ID | The Application (client) ID from your app registration | | Client Secret | The client secret you created |
Usage
- Add the Azure Log Analytics node to your workflow
- Select your configured credentials
- Enter your Workspace ID (found in the Log Analytics workspace overview in Azure Portal)
- Write your KQL query
- Optionally configure:
- Timespan: ISO 8601 duration (e.g.,
P1Dfor 1 day,PT1Hfor 1 hour) - Output Format: Return rows as JSON objects or raw API response
- Timespan: ISO 8601 duration (e.g.,
Example Query
AzureActivity
| where TimeGenerated > ago(1d)
| summarize count() by Category
| order by count_ desc