Skip to content

Stack Heath doc naming consistency#936

Merged
rr404 merged 2 commits intomainfrom
jdv_stackhealth_v1_0_1
Nov 26, 2025
Merged

Stack Heath doc naming consistency#936
rr404 merged 2 commits intomainfrom
jdv_stackhealth_v1_0_1

Conversation

@rr404
Copy link
Copy Markdown
Contributor

@rr404 rr404 commented Nov 26, 2025

No description provided.

@aws-amplify-eu-west-1
Copy link
Copy Markdown

This pull request is automatically being deployed by Amplify Hosting (learn more).

Access this pull request here: https://pr-936.d1to60jd2gb6y6.amplifyapp.com

@rr404
Copy link
Copy Markdown
Contributor Author

rr404 commented Nov 26, 2025

@copilot do you see any naming inconsistencies in my issues pages now

Copy link
Copy Markdown
Contributor

Copilot AI commented Nov 26, 2025

@rr404 I've opened a new pull request, #937, to work on those changes. Once the pull request is ready, I'll request review from you.

* Initial plan

* Fix naming inconsistencies in issue pages - use full names instead of abbreviations

Co-authored-by: rr404 <2361382+rr404@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: rr404 <2361382+rr404@users.noreply.github.com>
@rr404 rr404 merged commit 05be801 into main Nov 26, 2025
2 of 3 checks passed
@rr404 rr404 deleted the jdv_stackhealth_v1_0_1 branch November 26, 2025 12:47
title: Engine Too Many Alerts
id: issue_engine_too_many_alerts
title: Security Engine Too Many Alerts
id: issue_se_too_many_alerts
Copy link
Copy Markdown
Contributor

@buixor buixor Nov 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

common root causes : custom scenario without blackhole.
drop the Review acquisition configuration to ensure log files aren't listed multiple times: and only keep the acquis metric review
How to resolve:

  • For misconfigured scenarios -> disable or tune faulty scenarios

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated in #938

---
title: Security Engine Offline
id: issue_security_engine_offline
id: issue_se_offline
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Enrollment revoked or pending: Engine enrollment was removed from the Console or is awaiting approval. -> not possible
  • Enrollment revoked or pending -> kill
  • Console connectivity issues -> add cscli capi status
  • Re-enroll the engine in the Console -> kill

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok, updated in #938

title: Engine No Alerts
id: issue_engine_no_alerts
title: Security Engine No Alerts
id: issue_se_no_alerts
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

root causes:

  • Events massively whitelisted: ie. traffic coming from private IPs and being discarded by default allowlists.

Evaluate your service activity level:

  • suggest to check for massive allowlists/whitelists hits

Check if proactive defenses are blocking threats upstream -> kill

troubleshoot: suggest a cscli explain to ensure logs are not dropped by allowlists/whitelists

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated in #938

---
title: Log Processor Offline
id: issue_log_processor_offline
id: issue_lp_offline
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Look for errors -> too specific errors, jsut tell the user to look at the output
Also verify the API endpoint in /etc/crowdsec/config.yaml -> kill, too specific
Test network connectivity: -> kill, too specific
If the Local API service is unavailable + If the central LAPI is unreachable from the agent -> doublon ?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated in #938

---

The **LP No Logs Read** issue appears when a Log Processor is running but hasn't acquired any log lines in the last 24 hours. This is the first step in the detection pipeline and must work for CrowdSec to function.
The **Log Processor No Logs Read** issue appears when a Log Processor is running but hasn't acquired any log lines in the last 24 hours. This is the first step in the detection pipeline and must work for CrowdSec to function.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How to Resolve -> maybe too much details
If CrowdSec can't read log files: -> hallucination on user crowdsec, it doesn't exist

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated in #938

@@ -1,9 +1,9 @@
---
title: LP No Logs Parsed
title: Log Processor No Logs Parsed
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sudo cscli collections search nginx -> hallucination
Most services have a collection that includes parsers and scenarios: -> send the user to the hub
Option 1: Adjust log format to match parser -> danger. Point the user to cscli explain or suggest him to use stock logs.
Common Parser FILTER Values -> too specific

FOR ALL link the user to PS $$$

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated in #938

### If no logs are being read

Follow the [LP No Logs Read troubleshooting guide](/u/troubleshooting/issue_lp_no_logs_read) for detailed steps.
Follow the [Log Processor No Logs Read troubleshooting guide](/u/troubleshooting/issue_lp_no_logs_read) for detailed steps.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Identify the affected Log Processor -> already indicated by yhe console
FOR ALL NO ALERTS LP/SE : point to healthcheck scenarios

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated in #938

---

The **RC Integration Offline** (Remediation Component Integration Offline) refers to a Blocklist-Integration of type Remediation Component has not pulled from its endpoint for more than 24 hours.
The **Remediation Component Integration Offline** refers to a Blocklist-Integration of type Remediation Component has not pulled from its endpoint for more than 24 hours.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bouncer not loaded: Bouncer Module/plugin is installed but not enabled or started. -> no doublon
For host-based processes: too detailed
Standalone daemon bouncers -> too detailed, send the user to the dedicated bouncer page
For web server modules -> too detailed
If the API URL or API key is incorrect, update the bouncer's configuration file: -> too detailed
Enable the module/plugin -> too detailed

--- hallu
module not loaded - Integration not enabled in web server
invalid configuration - Config file syntax or parameter errors
rate limit exceeded - Cloud service plan limits reached

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated in #938

title: Firewall Integration Offline
id: issue_fw_integration_offline
id: issue_integration_fw_offline
---
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

// a few lines describe generic ways for them to check their firewall is workin and can ping https://admin.api.crowdsec.net/ -> rephrase c'est les notes pour le LLM
Navigate to the external blocklist configuration section (varies by vendor) -> too detailed on the submenus
Common log locations by vendor: Path to logs may vary depending on your firewall version, check your documentation. -> too detailed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants