Files
Anthropic-Cybersecurity-Skills/skills/implementing-alert-fatigue-reduction/references/api-reference.md
T
mukul975 27c6414ca5 Add folder anatomy (scripts/agent.py + references/api-reference.md) for 648 cybersecurity skills
Complete skill folder anatomy across all cybersecurity skills:
- scripts/agent.py: 80-150 line Python agents using real libraries (impacket,
  boto3, azure-mgmt-*, kubernetes, pefile, yara, scapy, shodan, stix2, etc.)
- references/api-reference.md: real API documentation with method signatures
- LICENSE: MIT license for all skill folders
2026-03-10 21:02:12 +01:00

2.0 KiB

API Reference: Implementing Alert Fatigue Reduction

Libraries

splunk-sdk (Splunk SDK for Python)

  • Install: pip install splunk-sdk
  • Docs: https://dev.splunk.com/enterprise/docs/devtools/python/sdk-python/
  • splunklib.client.connect(host, port, username, password) -- Connect to Splunk
  • service.jobs.create(query) -- Execute a search query
  • job.is_done() -- Check if search job completed
  • job.results(output_mode="json") -- Retrieve results in JSON format
  • splunklib.results.JSONResultsReader(stream) -- Parse JSON results

Splunk ES Notable Events API

  • Endpoint: /services/notable_update
  • Methods: POST to update notable event status
  • Fields: status, urgency, owner, comment, ruleUIDs
  • Status values: 0 (Unassigned), 1 (New), 2 (In Progress), 5 (Resolved)

Key SPL Queries

Purpose Key Functions
Alert volume analysis stats count by rule_name, eval fp_rate
Risk-based alerting collect index=risk, eval risk_score
Alert consolidation dedup src, rule_name span=300
Capacity calculation bin _time span=1d, stats avg(daily_alerts)
Tiered routing eval routing = case(urgency, ...)

Risk-Based Alerting (RBA) Framework

  • Risk contributions replace individual alerts
  • index=risk stores cumulative risk scores per entity
  • Threshold alert fires only when total_risk >= 75
  • Typical risk score ranges: 5 (low) to 50 (critical)

Metrics Targets

Metric Target
False Positive Rate < 30% per production rule
Alerts/Analyst/Shift 40-60 (manageable range)
Signal-to-Noise Ratio > 1.0
MTTD Under 15 minutes for critical
MTTR Under 4 hours for high severity

External References