get_impact_summary
Assess the impact of a Configuration Item by traversing downstream dependencies to identify affected services and applications, providing a categorized summary for change risk evaluation.
Instructions
Produce a summary of services and applications impacted by a given CI.
Traverses downstream relationships (CIs that depend on this CI) up to the specified depth, then categorizes the impacted CIs by class. Focuses on business-relevant classes: business applications, services, and application clusters. Also useful for blast radius analysis, change risk assessment, and understanding service dependencies before scheduled maintenance.
Use this tool for change impact assessment — understanding what would be affected if this CI goes down.
Prerequisites: Use search_cis to find the CI sys_id first.
Performance: Traversal can issue many API calls for deeply connected CIs. Consider using max_depth=2 for initial assessment, then increasing if needed. A hard 60-second timeout applies; on timeout, impact counts reflect only what was traversed before the deadline (timed_out=true).
Examples: get_impact_summary(ci_sys_id="abc123...", max_depth=2) get_impact_summary(ci_sys_id="abc123...", class_filter=["cmdb_ci_server", "cmdb_ci_linux_server"]) get_impact_summary(ci_sys_id="abc123...", max_depth=3)
Args: ci_sys_id: The sys_id of the CI to assess impact for (32-character hex string from search_cis). max_depth: How deep to traverse downstream dependencies (1-5, default 3). class_filter: Optional list of sys_class_name values to include in impact counts and results. Traversal still visits all CIs (to find matching descendants), but only matching classes appear in totals and lists. When None or empty, all classes are included.
Returns: JSON object with "ci" (the source CI), "total_impacted" count, "impacted_by_class" (breakdown by CI class), and "impacted_services" (list of business apps/services found in the tree).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ci_sys_id | Yes | ||
| max_depth | No | ||
| class_filter | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |