Blog
/
Proactive Security
/
June 25, 2024

Let the Dominos Fall! SOC and IR Metrics for ROI

Vendors are scrambling to compare MTTD metrics laid out in the latest MITRE Engenuity ATT&CK® Evaluations. But this analysis is reductive, ignoring the fact that in cybersecurity, there are far more metrics that matter.
Inside the SOC
Darktrace cyber analysts are world-class experts in threat intelligence, threat hunting and incident response, and provide 24/7 SOC support to thousands of Darktrace customers around the globe. Inside the SOC is exclusively authored by these experts, providing analysis of cyber incidents and threat trends, based on real-world experience in the field.
Written by
John Bradshaw
Sr. Director, Technical Marketing
Default blog image
25
Jun 2024

One of the most enjoyable discussions (and debates) I engage in is the topic of Security Operations Center (SOC) and Incident Response (IR) metrics to measure and validate an organization’s Return on Investment (ROI). The debate part comes in when I hear vendor experts talking about “the only” SOC metrics that matter, and only list the two most well-known, while completely ignoring metrics that have a direct causal relationship.

In this blog, I will discuss what I believe are the SOC/IR metrics that matter, how each one has a direct impact on the others, and why organizations should ensure they are working towards the goal of why these metrics are measured in the first place: Reduction of Risk and Costs.

Reduction of Risk and Costs

Every security solution and process an organization puts in place should reduce the organization’s risk of a breach, exposure by an insider threat, or loss of productivity. How an organization realizes net benefits can be in several ways:

  • Improved efficiencies can result in SOC/IR staff focusing on other areas such as advanced threat hunting rather than churning through alerts on their security consoles. It may also help organizations dealing with the lack of skilled security staff by using Artificial Intelligence (AI) and automated processes.
  • A well-oiled SOC/IR team that has greatly reduced or even eliminated mundane tasks attracts, motivates, and retains talent resulting in reduced hiring and training costs.
  • The direct impact of a breach such as a ransomware attack can be devastating. According to the 2024 Data Breach Investigations Report by Verizon, MGM Resorts International reported the ALPHV ransomware cost the company approximately $100 million[1].
  • Failure to take appropriate steps to protect the organization can result in regulatory fines; and if an organization has, or is considering, purchasing Cyber Insurance, can result in declined coverage or increased premiums.

How does an organization demonstrate they are taking proactive measures to prevent breaches? That is where it's important to understand the nine (yes, nine) key metrics, and how each one directly influences the others, play their roles.

Metrics in the Incident Response Timeline

Let’s start with a review of the key steps in the Incident Response Timeline:

Seven of the nine key metrics are in the IR timeline, while two of the metrics occur before you ever have an incident. They occur in the Pre-Detection Stage.

‍Pre-Detection stage metrics are:

  • Preventions Per Intrusion Attempt (PPIA)
  • False Positive Reduction Rate (FPRR)

Next is the Detect and Investigate stage, there are three metrics to consider:

  • Mean Time to Detection (MTTD)
  • Mean Time to Triage (MTTT)
  • Mean Time to Understanding (MTTU)

This is followed by the Remediation stage, there are two metrics here:

  • Mean Time to Containment (MTTC)
  • Mean Time to Remediation / Recovery (MTTR)

Finally, there is the Risk Reduction stage, there are two metrics:

  • Mean Time to Advice (MTTA)
  • Mean Time to Implementation (MTTI)

Pre-Detection Stage

Preventions Per Intrusion Attempt

PPIA is defined as stopping any intrusion attempt at the earliest possible stage. Your network Intrusion Prevention System (IPS) blocks vulnerability exploits, your e-mail security solution intercepts and removes messages with malicious attachments or links, your egress firewall blocks unauthorized login attempts, etc. The adversary doesn’t get beyond Step 1 in the attack life cycle.

This metric is the first domino. Every organization should strive to improve on this metric every day. Why? For every intrusion attempt you stop right out of the gate, you eliminate the actions for every other metric. There is no incident to detect, triage, investigate, remediate, or analyze post-incident for ways to improve your security posture.

When I think about PPIA, I always remember back to a discussion with a former mentor, Tim Crothers, who discussed the benefits of focusing on Prevention Failure Detection.

The concept is that as you layer your security defenses, your PPIA moves ever closer to 100% (no one has ever reached 100%). This narrows the field of fire for adversaries to breach into your organization. This is where novel, unknown, and permuted threats live and breathe. This is where solutions utilizing Unsupervised Machine Learning excel in raising anomalous alerts – indications of potential compromise involving one of these threats. Unsupervised ML also raises alerts on anomalous activity generated by known threats and can raise detections before many signature-based solutions. Most organizations struggle to find strong permutations of known threats, insider threats, supply chain attacks, attacks utilizing n-day and 0-day exploits. Moving PPIA ever closer to 100% also frees your team up for conducting threat hunting activities – utilizing components of your SOC that collect and store telemetry to query for potential compromises based on hypothesis the team raises. It also significantly reduces the alerts your team must triage and investigate – solving many of the issues outlined at the start of this paper.

False Positive Reduction Rate

Before we discuss FPRR, I should clarify how I define False Positives (FPs). Many define FPs as an alert that is in error (i.e.: your EDR alerts on malware that turns out to be AV signature files). While that is a FP, I extend the definition to include any alert that did not require triage / investigation and distracts the SOC/IR team (meaning they conducted some level of triage / investigation).

This metric is the second domino. Why is this metric important? Every alert your team exerts time and effort on that is a non-issue distracts them from alerts that matter. One of the major issues that has resonated in the security industry for decades is that SOCs are inundated with alerts and cannot clear the backlog. When it comes to PPIA + FPRR, I have seen analysts spend time investigating alerts that were blocked out of the gate while their screen continued to fill up with more. You must focus on Prevention Failure Detection to get ahead of the backlog.

Detect and Investigate Stages

Mean Time to Detection

MTTD, or “Dwell Time”, has decreased dramatically over the past 12 years. From well over a year to 16 days in 2023[2]. MTTD is measured from the earliest possible point you could detect the intrusion to the moment you actually detect it.

This third domino is important because the longer an adversary remains undetected, the more the odds increase they will complete their mission objective. It also makes the tasks of triage and investigation more difficult as analysts must piece together more activity and adversaries may be erasing evidence along the way – or your storage retention does not cover the breach timeline.

Many solutions focusing solely on MTTD can actually create the very problem SOCs are looking to solve.  That is, they generate so much alerting that they flood the console, email, or text messaging app causing an unmanageable queue of alerts (this is the problem XDR solutions were designed to resolve by focusing on incidents rather than alerts).

Mean Time to Triage

MTTT involves SOCs that utilize Level 1 (aka Triage) analysts to render an “escalate / do not escalate” alert verdict accurately. Accuracy is important because Triage Analysts typically are staff new to cyber security (recent grad / certification) and may over escalate (afraid to miss something important) or under escalate (not recognize signs of a successful breach). Because of this, a small MTTT does not always equate to successful handling of incidents.

This metric is important because keeping your senior staff focused on progressing incidents in a timely manner (and not expending time on false positives) should reduce stress and required headcount.

Mean Time to Understanding

MTTU deals with understanding the complete nature of the incident being investigated. This is different than MTTT which only deals with whether the issue merits escalation to senior analysts. It is then up to the senior analysts to determine the scope of the incident, and if you are a follower of my UPSET Investigation Framework, you know understanding the full scope involves:

U = All compromised accounts

P = Persistence Mechanisms used

S = All systems involved (organization, adversary, and intermediaries)

E = Endgame (or mission objective)

T = Techniques, Tactics, Procedures (TTPs) utilized by the adversary

MTTU is important because this information is critical before any containment or remediation actions are taken. Leave a stone unturned, and you alert the adversary that you are onto them and possibly fail to close an avenue of access.

Remediation Stages

Mean Time to Containment

MTTC deals with neutralizing the threat. You may not have kicked the adversary out, but you have halted their progress to their mission objective and ability to inflict further damage. This may be through use of isolation capabilities, termination of malicious processes, or firewall blocks.

MTTC is important, especially with ransomware attacks where every second counts. Faster containment responses can result in reduced / eliminated disruption to business operations or loss of data.

Mean Time to Remediation / Recovery

The full scope of the incident is understood, the adversary has been halted in their tracks, no malicious processes are running on any systems in your organization. Now is the time to put things back to right. MTTR deals with the time involved in restoring business operations to pre-incident stage. It means all remnants of changes made by the adversary (persistence, account alterations, programs installed, etc.) are removed; all disrupted systems are restored to operations (i.e.: ransomware encrypted systems are recovered from backups / snapshots), compromised user accounts are reset, etc.

MTTR is important because it informs senior management of how fast the organization can recover from an incident. Disaster Recovery and Business Continuity plans play a major role in improving this score.

Risk Reduction Stages

Mean Time to Advice

After the dust has settled from the incident, the job is not done. MTTA deals with identifying and assessing the specific areas (vulnerabilities, misconfigurations, lack of security controls) that permitted the adversary to advance to the point where detection occurred (and any actions beyond). The SOC and IR teams should then compile a list of recommendations to present to management to improve the security posture of the organization so the same attack path cannot be used.

Mean Time to Implement

Once recommendations are delivered to management, how long does it take to implement them? MTTI tracks this timeline because none of it matters if you don’t fix the holes that led to the breach.

Nine Dominos

There are the nine dominos of SOC / IR metrics I recommend helping organizations know if they are on the right track to reduce risk, costs and improve morale / retention of the security teams. You may not wish to track all nine, but understanding how each metric impacts the others can provide visibility into why you are not seeing expected improvements when you implement a new security solution or change processes.

Improving prevention and reducing false positives can make huge positive impacts on your incident response timeline. Utilizing solutions that get you to resolution quicker allows the team to focus on recommendations and risk reduction strategies.

Whichever metrics you choose to track, just be sure the dominos fall in your favor.

‍

References

[1] 2024 Verizon Data Breach Investigations Report, p83

[2] Mandiant M-Trends 2023

‍

‍

‍

Inside the SOC
Darktrace cyber analysts are world-class experts in threat intelligence, threat hunting and incident response, and provide 24/7 SOC support to thousands of Darktrace customers around the globe. Inside the SOC is exclusively authored by these experts, providing analysis of cyber incidents and threat trends, based on real-world experience in the field.
Written by
John Bradshaw
Sr. Director, Technical Marketing

More in this series

No items found.

Blog

/

AI

/

November 17, 2026

How Microsoft and Darktrace Secure the AI-Powered Enterprise

Default blog imageDefault blog image

When legitimate activity creates business risk

AI is making information more accessible and enabling autonomous agents to act across enterprise systems. But legitimate access can still result in sensitive-data exposure, unintended actions, or activity that deviates from business expectations.

Microsoft's evolving security strategy recognizes this shift, emphasizing continuous risk assessment, stronger identity protection, and security that adapts as AI systems operate. For enterprises, the challenge is increasingly about recognizing when trusted activity introduces risk, even when existing controls are functioning as intended.

Where global intelligence meets deep business context

Microsoft brings global threat intelligence and comprehensive security capabilities, helping organizations protect identities, data, applications, and infrastructure. Its integrated approach connects security signals, governance, detection, and response across increasingly complex environments.

Darktrace complements these strengths with deep, organization-specific behavioral understanding. Powered by Adaptive AI, Darktrace continuously learns the patterns and relationships unique to each business, developing a Unique Behavioral Profile for each organization that helps distinguish meaningful threats from legitimate activity. By connecting identity, activity, context, and intent, it adds another dimension to security intelligence.

Together, Microsoft and Darktrace combine global intelligence with deeper knowledge of how each customer operates. Through supported integrations, this behavioral context enriches existing Microsoft security workflows, enabling more informed investigations and precise response.

This complementary approach extends across three interconnected areas of enterprise security- AI, People and Infrastructure. From understanding how AI and agents operate to protecting trusted communications and the infrastructure businesses depend on, Darktrace strengthens Microsoft's security capabilities with behavioral insight specific to each organization.

Understanding AI beyond permissions and policies

As AI moves into business-critical operations, security teams need to understand more than which applications and agents are approved. They need visibility into how AI is used, what information it accesses, and whether its actions remain aligned with business intent.

Microsoft provides extensive AI development, governance, and security capabilities. Darktrace / SECURE AI complements these with behavioral analysis across Shadow AI, prompts, agent identities and actions, and development risk. Policy Manager helps evaluate activity against organizational AI policies, while the announced integration with Microsoft Agent 365 is designed to enrich agent risk assessments with organization-specific behavioral signals. Together, these capabilities help organizations scale AI adoption with greater confidence.

Recognizing risk within trusted relationships

Sophisticated threats increasingly exploit established business relationships, familiar communications, and legitimate accounts. A message from a trusted supplier or an action taken through an authorized identity may appear routine until considered against the organization's normal behavior.

Darktrace / EMAIL complements Microsoft's native email, identity, and data protection capabilities by understanding how people and organizations communicate. This enables more precise detection of targeted phishing, business email compromise, account takeover, and data loss, supported by proportionate response. Integrations such as Unified Quarantine within Microsoft Defender for Office 365 bring this additional protection into existing security workflows.

Seeing the bigger picture behind an attack across domains

Threats rarely unfold within a single security domain. Suspicious identity activity, unexpected cloud connections, and unusual network behavior may appear unrelated until the relationships between them reveal a developing attack.

Darktrace / HYBRID NETWORK complements Microsoft's security capabilities with organization-specific behavioral detection across network, cloud, identity, and operational technology. Real-Time AI Analyst, including Cyber AI Analyst, connects related activity into investigated incidents that can be delivered into Microsoft Sentinel, helping security teams accelerate investigations and support targeted containment across the hybrid enterprise.

Turning security intelligence into business confidence

As AI becomes more deeply integrated into business operations, organizations need security that understands not only what technology can access, but how it behaves within their unique environment.

Microsoft and Darktrace bring complementary strengths to that challenge. By connecting global threat intelligence and integrated security capabilities with deep behavioral understanding, the partnership helps organizations recognize emerging risks, respond with greater precision, and strengthen their existing security investments.

The opportunity is to turn security intelligence into meaningful business context, enabling organizations to innovate and operate AI with confidence.

Darktrace named a 2026 Microsoft Partner of the Year Finalist for ISV Innovation

Darktrace has been named a finalist for the 2026 Microsoft Partner of the Year Award in the ISV Innovation category.  

This recognition reflects our collaboration with Microsoft to bring business context to enterprise security. By connecting Microsoft's global threat intelligence and integrated security capabilities with Darktrace's deep behavioral understanding, we help organizations recognize emerging risks and respond with greater precision across AI, People and Infrastructure.

Thank you to Microsoft, our customers, and our teams for their continued collaboration.

Meet Darktrace at Microsoft Ignite and the Microsoft Frontier Tour

Explore how Darktrace and Microsoft are bringing behavioral security to AI, people, and infrastructure.

Join Darktrace at Microsoft Ignite in San Francisco, November 17–19, or connect with our experts as we join the Microsoft Frontier Tour across 21 cities worldwide.

Meet Darktrace at Microsoft Ignite

Connect with Darktrace at the Microsoft Frontier Tour

[related-resource]

Continue reading
About the author
Pallavi Singh
Senior Product Marketing Manager

Blog

/

AI

/

November 13, 2026

Introducing Darktrace MCP: Connect your AI assistants to the Darktrace Behavioral Defense Platform

Default blog imageDefault blog image

The Darktrace MCP Server is now generally available to users of the Darktrace Platform Portal. It enables compatible AI assistants to query security data, retrieve Cyber AI Analyst findings, and execute supported actions across actively licensed Darktrace products. Customers can now use these capabilities in their own AI workflows to gather incident context, search telemetry, enrich investigations with information from other services, and carry out triage tasks.

What is MCP?
MCP is an open standard developed by Anthropic that lets AI systems connect to and use enterprise tools and data. Adoption of MCP servers creates an opportunity for SOC teams to move beyond isolated AI experiences toward truly operational AI workflows.

Available capabilities

The server exposes tools for three areas of security work:

  • Incident discovery and threat hunting. Retrieve model alerts and incident groups, search for relevant devices and investigate indicators of compromise. Assistants with access to other services can combine these results with external threat intelligence.
  • Investigation and analysis. Retrieve Cyber AI Analyst incident findings, examine related event data, and enrich the investigation with information from other platforms or external documentation.
  • Triage and workflow actions. Add comments, tags and statuses to alerts and assets, modify supported settings such as trusted domains and subnet details, or trigger a Cyber AI Analyst investigation.

Available capabilities depend on the licensed products connected to the server. The toolset also includes access to Secure AI prompt and shadow AI information, cloud misconfigurations and external exposure information, and Email threat trends and supported management functions.

The following examples show how the server’s discovery, investigation, and action capabilities can be combined within an AI assistant.

Check external threat indicators against your environment

An assistant can use Darktrace MCP alongside external threat intelligence to check whether reported indicators appear in an environment. Darktrace’s tools provide device information and endpoint context; the assistant’s other tools or connected services supply the external intelligence.

In this example, the assistant searched for recent threat reports, selected indicators of compromise (IoCs) to investigate, and checked for devices that had communicated with the reported IP addresses. It then examined endpoint information to put the matches into context.

Relevant Darktrace tools: search_devices, get_endpoint_information, get_model_alerts, get_incident_events

Example prompt: “See what IoCs are appearing in recent threat reports online, identify the most critical one from the last week, and then analyze to see if it exists in my environment.”

AI assistant output using external threat intelligence alongside data retrieved through the Darktrace MCP Server.

Enrich a Cyber AI Analyst investigation

Cyber AI Analyst provides Darktrace’s incident analysis. Through MCP, an assistant can retrieve those findings, explain specific parts of an incident, and bring in related data from other services.

In this example, the assistant examined a Potential AWS Account Hijack investigated by Cyber AI Analyst. It assembled a step-by-step account and raw event timeline, then consulted AWS documentation to add relevant prevention guidance. The assistant brings together the existing Darktrace analysis, supporting events, and external guidance in one response.

Relevant Darktrace tools: get_incident_groups, get_incident_events, get_detailed_events, get_ai_analyst_investigations, advanced_search

Example prompt: “Drill down on the identified potential AWS account hijack. Show me a detailed step-by-step of what happened using data from Cyber AI Analyst, including a raw event timeline, and provide info on how to prevent this from happening again using info from AWS documentation.”

AI assistant output combining Cyber AI Analyst findings and event data with guidance from AWS documentation. Some sensitive content has been redacted.

Work through triage with analyst confirmation

The server’s action tools allow an assistant to support repetitive triage tasks as well as retrieve information. For example, to improve efficiency of a daily triage workflow, an analyst could ask an AI assistant to present untriaged alerts one at a time, summarizing each issue and suggesting a next step for confirmation.

The example below shows the assistant proposing actions such as recording a finding, acknowledging an incident, tagging an asset, or triggering a Cyber AI Analyst investigation for more detail. The analyst chooses how to proceed.

Relevant Darktrace tools: get_model_alerts, update_model_alert, update_incident_group, manage_tags, create_ai_analyst_investigation

Example prompt: “Using the Darktrace MCP server, obtain all un-triaged alerts from the last 3 days and display them one at a time. Provide a summary of the issue, and a suggested triage and immediate response action. I will confirm what action should be performed.”

AI assistant output proposing triage actions using information retrieved through Darktrace MCP and asking the analyst how to proceed. Some sensitive content has been redacted.

Permissions and security considerations

The MCP server provides access to supported capabilities within the products a customer is licensed to use. Connections should follow the principle of least privilege, with access appropriate to the intended workflow.

A read-only connection mode is also available for workflows that do not require changes. This mode hides tools that mutate data; configuration details are provided in the Product Guide.

Some tools can change data or perform actions, including adding or removing asset tags, triggering Cyber AI Analyst investigations, and acting on assets. Consider which capabilities an assistant should be able to use before connecting it and retain human oversight of actions that could cause disruption or unwanted changes.

For further guidance, see:

Seven MCP risks CISOs should consider and how to prepare

Anthropic’s MCP Security Best Practices

Use the interface that suits the task

MCP gives customers another way to work with Darktrace alongside its product interfaces. Users may find that complex investigations requiring visual analysis, or strategic decisions involving impactful actions, are better suited to the graphical interfaces within Darktrace products. They can choose the approach that fits their workflow.

How to start using the Darktrace MCP Server

The Darktrace MCP Server is used to connect a compatible AI assistant to supported tools within your Darktrace deployment. The assistant can retrieve alerts and device information, draw on Cyber AI Analyst findings, and perform permitted actions across your licensed products.

To get started, you will need access to the Darktrace Platform Portal and a compatible AI assistant. Follow the Platform Portal MCP Server guide to find out how to create the required credentials and configure the connection today.

Contact a Darktrace representative to explore how the Darktrace MCP Server can support your security operations.

To learn more about Darktrace can help protect your MCP servers within your broader AI and agent use, discover Darktrace / SECURE AI.

‍

Appendix: Darktrace MCP available tools

The following tool catalogue reflects the list supplied for this announcement. Available tools depend on the connected products and access. The list may change as tools are added or removed.

ToolProductDescription
get_helpGeneral / MCP ServerReturns orientation info about the Darktrace MCP server: its purpose, tool categories, and documentation.
get_productsGeneral / MCP ServerLists available Darktrace product instances and their instance_id values needed by other tools.
submit_feedbackGeneral / MCP ServerLogs feedback about tool coverage, clarity, or usability for the Darktrace team.
count_devicesThreat VisualizerReturns the total count of devices/assets managed by Darktrace.
search_devicesThreat VisualizerSearches for devices by keyword and returns basic matching device details.
query_devicesThreat VisualizerQueries comprehensive device information using filters like IP, MAC, subnet, or SaaS module.
edit_deviceThreat VisualizerUpdates a device's label, type, priority, or notes.
get_device_activityThreat VisualizerReturns aggregated time-series data of a device's connection/data volume trends over 4 weeks.
get_detailed_eventsThreat VisualizerRetrieves individual low-level events (connections, notices, model breaches, processes) for a device or alert.
get_subnetsThreat VisualizerRetrieves monitored subnets with CIDR, device counts, DHCP status, and traffic stats.
update_subnetThreat VisualizerEdits subnet details such as label, network range, coordinates, and DHCP/exclusion flags.
get_model_alertsThreat VisualizerRetrieves model alerts (breaches) with model info, device details, and triggered components.
get_model_alert_credentialsThreat VisualizerReturns credentials seen on the device that triggered a given model alert.
update_model_alertThreat VisualizerComments on and/or acknowledges a model alert.
get_modelsThreat VisualizerRetrieves detection models with their logic, actions, and configuration.
get_incident_groupsThreat VisualizerRetrieves AI Analyst incident groups with scores, MITRE tactics, devices, and summaries.
get_incident_eventsThreat VisualizerRetrieves AI Analyst incident events with AI summaries, MITRE tactics, and breach details.
update_incident_groupThreat VisualizerComments on and/or acknowledges an AI Analyst incident group.
create_ai_analyst_investigationThreat VisualizerCreates a manual AI Analyst investigation for a device around a specified time.
get_ai_analyst_investigationsThreat VisualizerRetrieves the status and results of manual AI Analyst investigations.
advanced_searchThreat VisualizerExecutes a Lucene-syntax Advanced Search query against Darktrace log data.
get_advanced_search_syntaxThreat VisualizerReturns the full Advanced Search query syntax reference (must be called before querying).
get_response_actions_summaryThreat VisualizerReturns a summary of active and pending Autonomous Response actions and action counts over a time range.
get_endpoint_informationThreat VisualizerLooks up external endpoints (IPs/hostnames) for location, reputation, and connection history.
get_cvesThreat VisualizerRetrieves CVEs detected across assets with severity, scores, and affected devices.
get_system_healthThreat VisualizerReturns comprehensive system health metrics (CPU, memory, disk, licenses, bandwidth).
get_dam_alertsThreat VisualizerRetrieves health alerts from the Darktrace Alert Management system.
get_module_statusesThreat VisualizerRetrieves the status of Darktrace modules, optionally filtered to failing ones.
get_tagsThreat VisualizerRetrieves device tags and optionally the devices/credentials they are applied to.
manage_tagsThreat VisualizerCreates, deletes, applies, or removes tags on devices or credentials.
get_trusted_domainsThreat VisualizerRetrieves domains marked as trusted.
manage_trusted_domainsThreat VisualizerAdds or removes a trusted domain entry.
get_watched_domainsThreat VisualizerRetrieves watched domains monitored for suspicious activity.
manage_watched_domainsThreat VisualizerAdds or removes watched domain entries.
get_workflow_integration_ticketsThreat VisualizerRetrieves third-party platform tickets created by Workflow Integrations for Darktrace events.
get_cloud_accountsDarktrace / HYBRID NETWORKRetrieves cloud deployment accounts and their monitoring/compliance statuses.
get_cloud_architecturesDarktrace / HYBRID NETWORKRetrieves cloud architectures with risk breakdown, cost, and asset counts.
get_cloud_assetsDarktrace / HYBRID NETWORKRetrieves cloud assets with type, service, region, and attached/associated assets.
get_cloud_asset_filtersDarktrace / HYBRID NETWORKReturns available filter fields and operators for querying cloud assets.
get_cloud_misconfiguration_alertsDarktrace / HYBRID NETWORKRetrieves cloud security misconfiguration alerts grouped by rule.
get_cloud_misconfigured_assetsDarktrace / HYBRID NETWORKRetrieves the assets affected by a specific cloud misconfiguration rule.
get_cloud_rule_informationDarktrace / HYBRID NETWORKReturns detailed rationale, remediation, and compliance mappings for a cloud security rule.
get_emailDarktrace / EMAILRetrieves detailed information about a specific email by UUID.
search_emailsDarktrace / EMAILSearches for emails using filters and a time range.
get_email_search_filtersDarktrace / EMAILReturns available email search filter definitions and values.
action_emailDarktrace / EMAILPerforms an action (hold, release, approve/reject release) on an email for specific recipients.
analyse_email_linkDarktrace / EMAILAnalyzes a URL found in an email, returning classification tags and analysis metrics.
get_email_overviewDarktrace / EMAILReturns an aggregated email dashboard overview (threats, actions, campaigns, etc.).
get_email_listsDarktrace / EMAILRetrieves email lists and their entries.
manage_email_listsDarktrace / EMAILAdds or edits email lists, and adds or removes entries within an email list.
get_email_addin_recordsDarktrace / EMAILRetrieves Inbox Analysis or Misdirected Email add-in records.
get_email_audit_logsDarktrace / EMAILRetrieves EMAIL system audit log events for a time range.
get_email_audit_log_event_typesDarktrace / EMAILReturns available audit log event types for filtering.
get_secure_ai_overviewDarktrace / SECURE AIReturns a dashboard overview of Secure AI activity (anomaly scores, sessions, prompt categories).
get_secure_ai_sessionsDarktrace / SECURE AIRetrieves monitored generative-AI sessions with risk levels and anomaly scores.
get_secure_ai_promptsDarktrace / SECURE AIRetrieves individual prompts for a Secure AI session with anomaly/risk classifications.
get_secure_ai_usersDarktrace / SECURE AIRetrieves users interacting with generative-AI apps, with risk scores and session counts.
get_secure_ai_eventsDarktrace / SECURE AIRetrieves raw events ingested by the Secure AI post-handler.
get_secure_ai_detectionsDarktrace / SECURE AIRetrieves detections raised by Secure AI models with scores and OWASP/ATLAS mappings.
get_secure_ai_response_actionsDarktrace / SECURE AIRetrieves Autonomous Response actions taken by Secure AI.
manage_secure_ai_response_actionDarktrace / SECURE AIClears, confirms, extends, or reactivates a Secure AI response action.
get_shadow_ai_dashboardDarktrace / SECURE AIReturns the Shadow AI dashboard of unsanctioned AI/LLM services detected.
get_shadow_ai_detectionsDarktrace / SECURE AIRetrieves individual Shadow AI detections for unsanctioned AI/LLM service usage.
get_forensic_investigationsDarktrace / HYBRID NETWORKRetrieves forensic investigations with status, alarm counts, and AI summaries.
get_forensic_evidencesDarktrace / HYBRID NETWORKRetrieves evidence items with alarm counts, OS details, and processing status.
get_forensic_evidence_fileDarktrace / HYBRID NETWORKReturns detailed file metadata/content (hash, strings, VirusTotal, AI description) from an evidence item.
browse_forensic_evidence_filesDarktrace / HYBRID NETWORKBrowses the filesystem of a forensic evidence item, filtering by severity, path, or name.
get_forensic_alarmsDarktrace / HYBRID NETWORKRetrieves alarms from an investigation or evidence item with severity and MITRE techniques.
get_forensic_artifactsDarktrace / HYBRID NETWORKRetrieves detection artifacts (files, hashes, processes, users, IPs, domains) from an investigation.
get_forensic_detectionsDarktrace / HYBRID NETWORKRetrieves XDR/EDR detections with MITRE ATT&CK mappings.
get_forensic_indicatorsDarktrace / HYBRID NETWORKRetrieves indicators of compromise (IOCs) from an investigation.
get_forensic_vulnerabilitiesDarktrace / HYBRID NETWORKRetrieves vulnerabilities (CVEs) with CVSS scoring and package info.
get_forensic_pipelinesDarktrace / HYBRID NETWORKRetrieves processing/acquisition pipelines with real-time status.
get_forensic_timelineDarktrace / HYBRID NETWORKRetrieves or facets timeline events from a forensic investigation.
get_forensic_search_syntaxDarktrace / HYBRID NETWORKReturns the Forensic Search query syntax reference (call before forensic timeline queries).

[related-resource]

Continue reading
About the author
Jamie Bali
Technical Author (AI) Developer
Your data. Our AI.
Elevate your network security with Darktrace AI