|
| 1 | +--- |
| 2 | +id: carbon-black-inventory |
| 3 | +title: Carbon Black Inventory |
| 4 | +sidebar_label: Carbon Black Inventory |
| 5 | +description: The Sumo Logic app for Carbon Black Inventory enables security analysts identify risks and configuration gaps to improve endpoint hygiene, faster response, and stronger overall security. |
| 6 | +--- |
| 7 | + |
| 8 | +import useBaseUrl from '@docusaurus/useBaseUrl'; |
| 9 | + |
| 10 | +<img src={useBaseUrl('img/integrations/security-threat-detection/vmcarecb.png')} alt="Carbon Black Inventory icon" width="90" /> |
| 11 | + |
| 12 | +The Sumo Logic app for Carbon Black Inventory offers comprehensive visibility into endpoint assets and their security posture across your environment. By consolidating key device data, including total device counts, compliance status, antivirus and sensor health, and vulnerability levels, the app enables security teams to quickly identify at-risk endpoints and configuration gaps. |
| 13 | + |
| 14 | +Dedicated panels highlight quarantined devices, non-compliant endpoints, systems with passive or outdated sensors, and devices lacking recent antivirus scans, allowing you to efficiently monitor operational hygiene and security coverage. Visualizations by operating system, vulnerability severity, and geographic location provide valuable context for prioritizing patching and remediation. |
| 15 | + |
| 16 | +By surfacing high-priority issues, such as stale endpoints, disabled firewalls, or devices located in embargoed regions, alongside a complete inventory summary, the Sumo Logic app for Carbon Black Inventory helps you maintain strong endpoint hygiene, reduce risk exposure, and support compliance initiatives. This unified view empowers teams to respond faster, improve device management, and strengthen security across the IT environment. |
| 17 | + |
| 18 | +:::info |
| 19 | +This app includes [built-in monitors](#carbon-black-inventory-alerts). For details on creating custom monitors, refer to [Create monitors for Carbon Black Inventory app](#create-monitors-for-the-carbon-black-inventory-app). |
| 20 | +::: |
| 21 | + |
| 22 | +## Log types |
| 23 | + |
| 24 | +This app uses Sumo Logic’s [Carbon Black Inventory Source](/docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/carbon-black-inventory-source/) to collect device logs from the Carbon Black Inventory platform. |
| 25 | + |
| 26 | +## Sample log message |
| 27 | + |
| 28 | +<details> |
| 29 | +<summary>Device Log</summary> |
| 30 | + |
| 31 | +```json |
| 32 | +{ |
| 33 | + "id": 2008, |
| 34 | + "name": "Device-NotReporting", |
| 35 | + "os": "WINDOWS", |
| 36 | + "os_version": "Windows 7", |
| 37 | + "last_external_ip_address": "2.58.14.95", |
| 38 | + "quarantined": false, |
| 39 | + "compliance_status": "COMPLIANT", |
| 40 | + "host_based_firewall_status": "ENABLED", |
| 41 | + "av_status": [ |
| 42 | + "AV_ACTIVE" |
| 43 | + ], |
| 44 | + "sensor_pending_update": false, |
| 45 | + "sensor_out_of_date": false, |
| 46 | + "passive_mode": false, |
| 47 | + "sensor_states": [ |
| 48 | + "LIVE_RESPONSE_NOT_RUNNING" |
| 49 | + ], |
| 50 | + "av_last_scan_time": "2025-09-25T19:11:38.742Z", |
| 51 | + "vulnerability_score": 2.5, |
| 52 | + "vulnerability_severity": "LOW", |
| 53 | + "last_contact_time": "2025-09-25T19:11:38.742Z", |
| 54 | + "last_reported_time": "2025-09-25T19:11:38.742Z", |
| 55 | + "registered_time": "2025-09-25T19:11:38.742Z" |
| 56 | +} |
| 57 | +``` |
| 58 | +</details> |
| 59 | + |
| 60 | +## Sample queries |
| 61 | + |
| 62 | +```sql title="Total Devices" |
| 63 | +_sourceCategory="Labs/CarbonBlackInventory" |
| 64 | +| json "id", "quarantined", "compliance_status", "host_based_firewall_status", "av_status", "sensor_pending_update", "os", "vulnerability_severity", "last_external_ip_address", "sensor_states", "passive_mode", "name", "sensor_out_of_date", "last_reported_time", "last_contact_time", "registered_time", "vulnerability_score", "os_version", "av_last_scan_time" as id, quarantined, compliance_status, host_based_firewall_status, av_status_list, sensor_pending_update, os, vulnerability_severity, last_external_ip_address, sensor_states_list, passive_mode, name, sensor_out_of_date, last_reported_time, last_contact_time, registered_time, vulnerability_score, os_version, av_last_scan_time nodrop |
| 65 | + |
| 66 | +| where os matches "*" |
| 67 | +| where vulnerability_severity matches "*" |
| 68 | + |
| 69 | +| count by id |
| 70 | +| count |
| 71 | +``` |
| 72 | + |
| 73 | +## Collection configuration and app installation |
| 74 | + |
| 75 | +import CollectionConfiguration from '../../reuse/apps/collection-configuration.md'; |
| 76 | + |
| 77 | +<CollectionConfiguration/> |
| 78 | + |
| 79 | +:::important |
| 80 | +Use the [Cloud-to-Cloud Integration for Carbon Black Inventory](/docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/carbon-black-inventory-source/) to create the source and use the same source category while installing the app. By following these steps, you can ensure that your Carbon Black Inventory app is properly integrated and configured to collect and analyze your Carbon Black Inventory data. |
| 81 | +::: |
| 82 | + |
| 83 | +### Create a new collector and install the app |
| 84 | + |
| 85 | +import AppCollectionOPtion1 from '../../reuse/apps/app-collection-option-1.md'; |
| 86 | + |
| 87 | +<AppCollectionOPtion1/> |
| 88 | + |
| 89 | +### Use an existing collector and install the app |
| 90 | + |
| 91 | +import AppCollectionOPtion2 from '../../reuse/apps/app-collection-option-2.md'; |
| 92 | + |
| 93 | +<AppCollectionOPtion2/> |
| 94 | + |
| 95 | +### Use an existing source and install the app |
| 96 | + |
| 97 | +import AppCollectionOPtion3 from '../../reuse/apps/app-collection-option-3.md'; |
| 98 | + |
| 99 | +<AppCollectionOPtion3/> |
| 100 | + |
| 101 | +## Viewing the Carbon Black Inventory dashboards |
| 102 | + |
| 103 | +import ViewDashboards from '../../reuse/apps/view-dashboards.md'; |
| 104 | + |
| 105 | +<ViewDashboards/> |
| 106 | + |
| 107 | +### Overview |
| 108 | + |
| 109 | +The **Carbon Black Inventory – Overview** dashboard offers a comprehensive snapshot of endpoint assets and their security posture. It highlights key metrics such as total device count, quarantined systems, compliance issues, and devices with outdated scans or disabled protections. The dashboard also provides visibility into inactive or outdated sensors, non-reporting endpoints, and pending sensor updates, along with breakdowns by operating system, vulnerability severity, and geographic location. By consolidating these insights into a unified view, it enables security teams to quickly identify at-risk devices, maintain compliance, and prioritize remediation efforts to improve endpoint hygiene and reduce organizational risk.<br/><img src='https://sumologic-app-data-v2.s3.us-east-1.amazonaws.com/dashboards/carbon-black-inventory/Carbon+Black+Inventory+-+Overview.png' alt="Carbon-Black-Inventory-Overview-Dashboard" /> |
| 110 | + |
| 111 | +## Create monitors for the Carbon Black Inventory app |
| 112 | + |
| 113 | +import CreateMonitors from '../../reuse/apps/create-monitors.md'; |
| 114 | + |
| 115 | +<CreateMonitors/> |
| 116 | + |
| 117 | +### Carbon Black Inventory alerts |
| 118 | + |
| 119 | +| Name | Description | Trigger Type (Critical / Warning / MissingData) | Alert Condition | |
| 120 | +|:--|:--|:--|:--| |
| 121 | +| `Carbon Black Inventory – Devices from Embargoed Locations` | This alert is triggered when one or more endpoints report external IP addresses associated with embargoed or restricted geographies. This helps ensure compliance with corporate and regulatory security requirements. | Critical | Count > 0 | |
| 122 | +| `Carbon Black Inventory – Firewall Disabled Devices` | This alert is triggered when an endpoint's host-based firewall protection is disabled, increasing exposure to network-based attacks and lateral movement. | Critical | Count > 0| |
| 123 | +| `Carbon Black Inventory – Endpoints Not Reporting` | This alert is triggered when a device has not communicated with Carbon Black for more than 7 days, potentially indicating an unmanaged, offline, or compromised endpoint. | Critical | Count > 0| |
| 124 | +| `Carbon Black Inventory – Outdated or Inactive Sensors` | This alert is triggered when endpoints are running outdated sensors or have inactive sensor states, which may reduce visibility and impair policy enforcement. | Critical | Count > 0| |
| 125 | +| `Carbon Black Inventory – High Vulnerability Devices` | This alert is triggered when endpoints report high or critical vulnerability scores, highlighting an elevated risk of exploitation and the need for prioritized patching. | Critical | Count > 0| |
| 126 | + |
| 127 | +## Upgrading/Downgrading the Carbon Black Inventory app (Optional) |
| 128 | + |
| 129 | +import AppUpdate from '../../reuse/apps/app-update.md'; |
| 130 | + |
| 131 | +<AppUpdate/> |
| 132 | + |
| 133 | +## Uninstalling the Carbon Black Inventory app (Optional) |
| 134 | + |
| 135 | +import AppUninstall from '../../reuse/apps/app-uninstall.md'; |
| 136 | + |
| 137 | +<AppUninstall/> |
0 commit comments