Graylog CrowdStrike Falcon input for alerts and event streams

Graylog pulls Falcon alerts and event streams directly from the CrowdStrike API through an Enterprise-licensed input. This page covers the license, API client setup, content pack and correlation with other logs.

On this page

How the CrowdStrike Falcon input brings EDR alerts into Graylog

EDR alerts from CrowdStrike Falcon usually sit in the Falcon console, while the investigation that follows needs them beside firewall, identity and host logs in Graylog. The Graylog CrowdStrike input closes that gap by pulling Falcon data directly from the CrowdStrike API into Graylog, so analysts can search, correlate and alert on endpoint detections with the rest of the environment. It covers two data types: alerts, which are the detections Falcon has raised, and event streams, which carry the broader telemetry feed. Graylog Open alone does not include this input. It is a Graylog Enterprise feature, so the license decision comes before any design work starts.

Before configuring anything, confirm three things with your Falcon administrator and your Graylog licensing contact. First, only a Falcon Administrator can create the API client that Graylog uses, so that person must be available during setup. Second, the API client needs read permissions for Alerts and Event streams, and nothing broader should be granted without a reason. Third, the client secret is displayed only once, so it must be stored in your approved secrets process at the moment it is created. Each of these steps is a common point where setup stalls, and each one determines who owns the credential after the project ends.

Plan the input as an ongoing data source, not a one-time import. The API client, its permissions and the secret rotation schedule are operational items that need an owner, and the Falcon tenant or region you connect to should be written down in the design record. Ask your Graylog partner or internal team to confirm how the input's polling and data retention interact with your index sets, since high event volumes affect storage sizing. Verify the exact field names and content pack version against the documentation for your Graylog release before you build searches on them, because those details can change between versions.

What you need before creating the CrowdStrike input

The CrowdStrike input is an Enterprise feature that depends on three things lining up: a licensed Graylog cluster, a Falcon API client with the right read scopes, and network paths from your Graylog servers to CrowdStrike. Check each one before you open the input form, because missing items usually surface only as failed connections.

Graylog Enterprise license

The CrowdStrike input is a Graylog Enterprise feature, so Graylog Open alone will not offer it. Confirm the license covers the cluster that will run the input before planning the build. Ask Graylog which edition and data volume your license includes, since the pricing page lists Enterprise with a minimum of 10 GB per day or 100 Graylog Compute Units. Check that the license is applied before the input is created.

Supported Graylog version

Pick the Graylog release line first, then check the compatibility matrix for the MongoDB and OpenSearch or Data Node versions it needs. The current documentation covers 7.2, so confirm the input behaves as documented on the exact release you run. Plan any upgrade before you build, since version changes can alter input behavior and the surrounding content pack.

Falcon Administrator for the API client

Only a Falcon Administrator can create API clients in the CrowdStrike console. Identify that person before the change window, because a standard analyst account cannot complete this step. Agree on who owns the client after creation, who can rotate it, and how the change is recorded in your access review process.

Alerts and Event streams read scopes

The API client needs read permissions for Alerts and Event streams. Grant only these scopes, and avoid reusing a broader client that another tool already holds. Write down the scopes in your change record so an auditor or a later engineer can see why the client has access, and verify them with a test pull before relying on the input.

Outbound access to the regional API

Graylog servers must reach the CrowdStrike API endpoint for your cloud region over HTTPS. Confirm the exact hostname for your tenant with CrowdStrike and check it against the egress rules of your firewall or proxy. Graylog nodes behind a restricted network need that path approved before the input can poll, and DNS resolution must work from every node that runs the input.

Storing the one-time client secret

The client secret is shown only once, at creation. If nobody saves it at that moment, the client must be recreated. Store the ID and secret in a secrets vault your team already operates, with access limited to the people who manage the Graylog input. Do not paste the secret into tickets, shared notes or configuration files kept in version control.

Configure the CrowdStrike API client and Graylog input

This sequence creates a read-only CrowdStrike API client, hands its credentials to a Graylog CrowdStrike input, and confirms that Falcon alerts and event streams arrive in searchable Graylog streams.

  1. Confirm the Enterprise license and access

    Before touching Falcon, confirm that the Graylog cluster runs on a license that includes the CrowdStrike input, since Graylog documents it as an Enterprise feature. Also confirm that someone on your team holds the Falcon Administrator role, because only a Falcon Administrator can create API clients. Check that the Graylog server nodes can reach the CrowdStrike API endpoint for your region over HTTPS. You are done when the license shows the input as available in your Graylog system and the person who will create the client has confirmed the Falcon role.

  2. Create the Falcon API client with read scopes

    A Falcon Administrator opens the API clients section of the Falcon console and creates a new client. Grant read permissions for Alerts and Event streams only, and avoid broader scopes, so the Graylog input can read detections without any ability to change them. Record the client ID and the client secret at creation time, because the secret is shown only once. Store the secret in your team's secrets manager straight away. You are done when the client appears in the console with the two read scopes listed and the secret is stored outside the chat or ticket where the request was made.

  3. Create the CrowdStrike input in Graylog

    In Graylog, open System, then Inputs, and select the CrowdStrike input from the available input types before launching it on a node. Give the input a descriptive title that names the Falcon tenant or environment, so later audits and troubleshooting can tell tenants apart. Leave the input unsaved until the credentials and region are entered in the next step. You are done when the input form is open with the title set and the input type shows as CrowdStrike.

  4. Enter the client credentials and region

    Paste the client ID and client secret from the Falcon console into the input's configuration fields. Select the CrowdStrike cloud region that matches your Falcon tenant, because a mismatched region produces failed API calls that look like authentication errors. Keep the Graylog configuration secret fields encrypted at rest and limit who can edit the input. You are done when the form validates the fields without error and the input saves to the cluster without a credential warning.

  5. Assign a target stream and index set

    Choose the stream that should receive CrowdStrike messages, and check that the stream routes to an index set with the retention and storage tier your security team expects. Separating Falcon alerts from general server logs in their own stream makes later event definitions and access rules easier to scope. Confirm which index set the stream writes to before the input starts, because changing it later does not move messages already indexed. You are done when the input configuration names one stream and that stream names one index set you have reviewed.

  6. Start the input and verify ingestion

    Start the input on a Graylog node and open the input's status page. Wait for the input to show as running with no repeated error messages in the node log, and then open search over the time range since start. Filter on the CrowdStrike source or the input title to confirm that alert and event stream messages appear. If the input runs but no messages arrive, check the Falcon client scopes, the region setting and whether the tenant has produced alerts in the period. You are done when the input reports running and at least one Falcon message is searchable in its target stream.

Which Falcon fields map to Graylog streams and searchable fields

This table sets out the decisions to make when Falcon alert and event stream records arrive in Graylog: how records are routed into streams, which index set holds them, and how fields become searchable. Field names depend on the data the API returns and the content pack version, so confirm every name against a live sample from your own input before building searches or alerts on it.

Mapping decisionWhat to decideWhat to confirm in your environmentWhy it matters
Source record typeKeep alerts and event stream records distinct so each has its own routing and retentionWhich record types your API client returns during a test pullMixed record types in one stream make searches and alert conditions harder to write
Stream routingCreate a stream rule set for Falcon records based on a stable source or type fieldThe exact field that identifies the record type in your sampleRouting on a field that changes between data versions breaks downstream alerts silently
Index set assignmentChoose an index set for Falcon data separate from high-volume host logs where retention differsRetention requirements from your own policy and the index set settings in your deploymentSeparate index sets let you apply different rotation and retention to security alert data
Searchable field namesDecide which fields analysts search on, such as host, severity and detection identifiersThe field names that appear in the live sample, not in the documentation aloneAnalysts need consistent names to pivot between Falcon alerts and other sources
Timestamp fieldConfirm which field Graylog uses as the message time for each recordWhether the source timestamp or ingestion time is used in your input setupWrong time mapping distorts timelines during investigations and correlation
Content pack alignmentDecide whether to use the matching content pack or map fields manuallyThe content pack version that matches your Graylog version and the fields it expectsMismatched content pack versions can rename or omit fields after an upgrade
Field naming and extractionDecide whether to keep raw field names or normalize them to a shared schemaWhether other EDR or identity sources in your stack use the same namesShared naming makes cross-source correlation practical

Choosing the matching content pack and when to build your own

Choose this path when your Falcon data fits what the content pack expects: alerts and event streams pulled through the Graylog CrowdStrike input without custom event types. The content pack provides parsing and dashboards aligned with the input, so your team can review detections early instead of mapping every field by hand. Treat it as a working baseline and record every change you make to it.

  • Parsing: the pack normalizes Falcon fields so searches and dashboards use consistent names.
  • Dashboards: prebuilt views show alert and event activity that you can adapt from a working baseline.
  • Scope check: confirm the pack covers the alert and event stream types your API client is permitted to read.
  • Change tracking: keep edits in version control or a documented change log so a later pack update does not silently overwrite your work.

Confirm the pack name and the input version it targets in the Graylog CrowdStrike input documentation before you install it.

Securing the CrowdStrike API client and Graylog input

The CrowdStrike input gives Graylog a standing credential into your EDR alert and event data, so the API client, its secret and the people who can edit the input all need controls. The cards below cover the decisions that keep that access narrow, recoverable and auditable.

Scope the API client to read only

Create the API client with read permissions for Alerts and Event streams only, and no write, containment or administrative scopes. Graylog only needs to pull records, so a read-only client limits what a leaked secret could do in your Falcon tenant. Only a Falcon Administrator can create API clients, so decide in advance who holds that role and who reviews the scope. Confirm the exact permission names in your Falcon console before you save the client.

Store and rotate the client secret

The client secret is shown only once, so copy it straight into your approved secrets manager and record which Graylog input uses it. Do not paste it into tickets, chat or configuration files kept in version control. Plan a rotation procedure before go-live: create a new client, update the input, confirm that alerts are still arriving, then retire the old client. Ask your team how long the rotation takes in your change process.

Restrict who can edit inputs

Anyone who can change the CrowdStrike input can redirect its data, reveal its configuration or add a new secret, so limit input administration to a named group of Graylog administrators. Keep read access to alerts in the streams that analysts need, and separate that from the ability to modify inputs. Review these role assignments on the same schedule as your other privileged access reviews, and confirm the role model in your Graylog version before you finalize it.

Limit outbound access to CrowdStrike

Graylog server nodes should reach only the CrowdStrike API endpoints needed for the input, over HTTPS, and nothing else on that path. Put this rule in your egress firewall or proxy allowlist and log denied requests so a misconfigured input shows up quickly. Confirm the regional endpoint for your Falcon cloud with CrowdStrike and your network team, since the host name depends on where your tenant is hosted.

Audit input and secret changes

Record who created or changed the CrowdStrike input, who created or revoked the API client and when each secret was rotated. Keep these records outside the Graylog cluster so an attacker who gains admin access to Graylog cannot erase them. Compare the audit trail against your change tickets during reviews, and confirm which events your Falcon and Graylog audit logs record in your versions.

Why EDR telemetry needs this protection

CIS Controls v8.1 Safeguard 10.1 expects anti-malware software on enterprise assets, and Safeguard 10.7 adds behavior-based detection, which is the kind of signal EDR alerts carry. If Graylog holds those alerts, the integrity and availability of the input are part of your detection coverage, so a broken or over-privileged input weakens the controls you rely on. Map these checks to your own control catalog with your assessor rather than treating the safeguard numbers as proof of compliance.

Correlating EDR alerts with firewall, identity and host logs

Correlation starts with shared fields, not with the alert itself. Once Falcon alerts arrive through the CrowdStrike input, decide which fields in each alert can be matched against firewall, identity and host logs: the host name, the user account, the source or destination IP address and a time window around the detection. Write these choices down before building anything. Falcon alert fields, firewall fields (for example, the source and destination address and the NAT translation if the firewall performs it), identity fields such as the sign-in user principal, and host log fields such as the hostname each need to be mapped to a common name in Graylog. Confirm the exact field names in your own Falcon data and in each source's parsed output, because the input and content packs may name them differently.

Event definitions and dashboards are then built on those joins. Correlation depth depends on the Enterprise correlation engine, so confirm with your Graylog license holder which correlation features your edition includes before you design multi-source rules. The practical limit is naming consistency. If the EDR sees a host as an FQDN, the firewall logs a bare IP address and the identity provider records a UPN, a join on host or user will silently miss events. Plan a normalization step in pipeline rules or stream routing, test it with a known detection, and check that a sample alert returns the matching firewall and sign-in events within the chosen time window. Dashboards should reuse the same field names so an analyst can pivot from an alert to the related traffic without retyping search terms.

Common failures when the CrowdStrike input stays silent

This table lists the failures that most often leave the Graylog CrowdStrike input without messages, with the cause and a check you can confirm in the Graylog and Falcon consoles. Work through the rows in order, since a license or permission gap blocks everything below it. Most silent inputs trace back to the first three rows.

SymptomLikely causeCheck or fix
Input cannot be started or shows an error about featuresGraylog Enterprise license is missing or does not cover the CrowdStrike inputIn Graylog, confirm the license is applied and the CrowdStrike input appears in the input types list. Ask your Graylog contact which edition includes it.
Input runs but returns authentication or authorization errorsAPI client lacks read permissions for Alerts or Event streamsIn the Falcon console, open the API client and confirm read scope for both Alerts and Event streams. Recreate the client with the right scope if either is missing.
Cannot find or edit the API client in FalconThe user creating the client is not a Falcon AdministratorConfirm the person creating the client holds the Falcon Administrator role. Ask a Falcon Administrator to create the client if not.
Credentials rejected after saving the inputClient secret was lost or not copied when first shownThe secret is displayed only once. If it was not saved, regenerate or create a new API client in Falcon and enter the new secret in the input.
Connection timeouts or no response from the APIWrong cloud region in the input, or egress to the CrowdStrike API is blockedMatch the base URL and region to the tenant shown in your Falcon console. Test outbound HTTPS from the Graylog server nodes to the CrowdStrike endpoints your firewall policy allows.
Input shows running but the message count stays at zeroNo new alerts or events in the polling window, or the Event streams scope is incompleteCheck the input diagnostics and message counts, then confirm alerts exist in Falcon for the same period. Verify the Event streams permission and widen the test window.
Messages arrive but fields are unparsed or dashboards are empty after an upgradeContent pack version does not match the upgraded Graylog releaseCompare the installed content pack version with the Graylog version in the Graylog docs for CrowdStrike. Reinstall the matching pack and confirm the streams route to it.

Questions buyers ask before setting up the CrowdStrike input

Does the Graylog CrowdStrike input need an Enterprise license?

Yes. The CrowdStrike input is a Graylog Enterprise feature that pulls data directly from the CrowdStrike API, so it is not available in Graylog Open. The Graylog pricing page lists Graylog Enterprise starting at 15,000 US dollars per year, with a minimum of 10 GB per day or 100 Graylog Compute Units, and licensing based on processed data with no per-user or per-device fees. Confirm the exact quote, volume tier and renewal terms with Graylog before you plan the build, because the starting price does not reflect your ingest volume. Graylog Open remains free, but it cannot run this input.

What drives the effort to set up the CrowdStrike input?

Effort depends on four things: how many data types you pull (alerts, event streams, or both), how many correlation rules you build across EDR and other logs, how much of any supplied content pack you adapt to your field names and streams, and how much testing you do before alerts reach an on-call queue. Each added data type or correlation rule adds configuration, validation and documentation work. Ask any partner to break the quote down by these four items so you can see which ones you are paying for and which you can reduce.

What do Falcon and Graylog admins need to provide?

On the Falcon side, only a Falcon Administrator can create the API client, and that client needs read permissions for Alerts and Event streams. Plan for the client secret to be shown only once, so store it in your approved secrets store at the moment it is created. On the Graylog side, an admin needs an Enterprise license applied, permission to create the input and the content pack, and a place to route the resulting streams. Agree in advance who holds each role so the work does not stall waiting for a single person.

Can our own team set up the CrowdStrike input without a partner?

Yes, if your team has an administrator who can create the Falcon API client, a Graylog administrator with Enterprise access, and engineers who can write and test correlation logic. The setup steps are documented, and the hard parts are usually scoping which alerts matter, mapping fields into your stream model and proving that alerts fire and route correctly. Teams that lack the Graylog or detection engineering time often choose a fixed-scope engagement for the design and testing, then run the input themselves. Decide based on who will own the input after go-live.

How do Graylog upgrades affect the CrowdStrike input?

Treat every Graylog upgrade as a change that needs a test. Graylog documents version-specific changes, and the current documentation covers version 7.2. Before you upgrade, confirm the input still loads, that the API client still has the same permissions, and that any content pack or correlation rule still parses the fields it uses. Check the compatibility matrix for your MongoDB and OpenSearch or Data Node versions as well, because runtime prerequisites can change between releases. Build the upgrade check into your change process rather than discovering a break after an alert has been missed.

How does the CrowdStrike input help with malware and EDR compliance evidence?

The input brings Falcon alerts into the same place as your other logs, which supports detection and review evidence. CIS Controls v8.1 Safeguard 10.1 asks for anti-malware software on enterprise assets, and related safeguards cover automatic signature updates, central management and behavior-based detection. Graylog can hold the alerts and show that they were reviewed, but it does not replace the EDR product or make you compliant on its own. Ask your assessor which control mappings they expect, and confirm the evidence you need with them before you design the streams.

Which logs should we correlate with CrowdStrike alerts first?

Start with the sources that explain what an endpoint alert means in your environment:

  • Identity sign-in and directory logs, to tie a host alert to a user session
  • Firewall or proxy logs, to see whether the same host reached unexpected destinations
  • Server and Windows security events, such as process creation and account changes

Add sources one at a time and test each correlation with a known scenario. This keeps the rule set understandable and makes it easier to tune false positives. Confirm which fields each source provides before you write the rule, because correlation fails silently when a host name or user field is named differently across sources.

What should we confirm with CrowdStrike before building the input?

Confirm the Falcon features and data types your subscription exposes, the API client permissions required for those data types, and any rate or retention limits that affect polling. Ask who approves API clients in your tenant and how secrets are rotated. Also confirm the network path from your Graylog nodes to the CrowdStrike API endpoints, since outbound rules are often the cause of delayed setup. Check these details against the Graylog CrowdStrike input documentation and your Falcon console, because the input depends on both.

How DeployOpen scopes and delivers the CrowdStrike integration

DeployOpen plans and builds the CrowdStrike Falcon input in Graylog inside your own infrastructure, starting from a written scope that names the alert and event stream sources, the API client and the correlation rules you need. Engagements are fixed-scope, with deliverables and timelines agreed in writing before work starts.

How we scope

  • We confirm your Graylog edition and Enterprise license coverage before any input configuration begins.
  • We record which Falcon alert and event stream feeds matter to your SOC and which fields downstream searches depend on.
  • We agree in writing who creates the Falcon API client, since only a Falcon Administrator can do it, and who holds the secret.

How we build

  • We configure the CrowdStrike input with read permissions for Alerts and Event streams and test polling against a non-production Graylog first.
  • We install and review the matching content pack, then adjust streams and field mappings to match your naming and retention rules.
  • We build event definitions that correlate Falcon alerts with identity, network and host logs, and test each one with sample events.

How we hand over

  • You receive a written record of the API client scope, input settings, stream routing and the network paths the input requires.
  • Runbooks cover rotating the client secret, which is shown only once, and recovering the input after a credential change.
  • We walk your team through the correlation searches and alert notifications so they can adjust thresholds and add new cases.

How we support

  • Ongoing support, upgrades and continuous testing are available as a retainer after handover.
  • Retainers can cover Graylog version changes that affect the CrowdStrike input or the content pack before you upgrade.
  • We can re-run tests of the Falcon feeds and correlation rules when your Falcon configuration or detection content changes.

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.