Default language.

Discovery Access node

Each time an endpoint is discovered, a Discovery Access node is created. It has relationships to the retrieved discovery information. Discovery Access nodes are created even if discovery fails, so that failed access is clearly identified in the model.

The endpoint attribute of a Discovery Access node describes the target used for discovery. The target for discovery is currently an IP v4 or IP v6 address.

Info

Network Device nodes created using the pattern language, for example stacked switches and access points, do not have a related Discovery Access node.

Discovery Access Lifecycle

The following section describes the scenarios in which a Discovery Access is created or destroyed. DDD nodes are never updated.

Creation

A Discovery Access node is created when BMC Discovery scans an IP address and that IP address is not considered to be dark space. This is either:

  • when there has never been a response on the IP address, or
  • when there has been no response for long enough for a previously discovered device to age out, it is then considered to be dark space.

Removal

Aging parameters exist for Directly Discovered Data Nodes which have a particular cut-off time. The Aging process will remove any Discovery Access Nodes and all of the other DDD Nodes associated with that node if this default time period is exceeded.

However, if the Discovery Access Node is the only one for an endpoint, then it is not removed, unless it is considered dark space. This enables BMC Discovery to keep a permanent record of every endpoint that has ever been scanned. These Discovery Access Nodes are the only ones which can exceed the default cut-off Aging process. 

The cut-off time is configurable, see DDD removal for more information.

Attributes of the DiscoveryAccess node

The attributes of the DiscoveryAccess node are described in the following table:

UI Name
Attribute Name and Type		Description 
Scope
scope : string 		Distinguish overlapping address spaces
Endpoint
endpoint : string 		Accessed address or endpoint
Scan Kind
scan_kind : string 		Kind of scan
Not shown in UI
#index : int 		Index of endpoint for owning range
Discovery Controlled By
reasoning_uuid : string 		Reasoning machine that performed discovery
Not shown in UI
#engine_id : int 		ECA engine on Reasoning machine the performed discovery
State
state : string 		State of access  completed, in progress, etc
Start Time
starttime : date 		Date and time this discovery access was created
End Time
endtime : date 		Date and time this discovery access ended
Discovery Start Time
discovery_starttime : date 		Date and time access started
Discovery End Time
discovery_endtime : date 		Date and time access ended
Result
result : string 		Result of access
End State
end_state : string 		Final state of access
Reason
reason : string 		Reason for failure, if any
On Hold Since
is_being_held : date 		True if access is on hold waiting for a scan window
On Hold Duration
on_hold_duration : int 		How long the access was held waiting for a scan window
Not shown in UI
#_first_marker : boolean 		True if this is the first DiscoveryAccess for an endpoint
Not shown in UI
#_last_marker : boolean 		True if this is the last DiscoveryAccess for an endpoint
Dark Space
dark_space : boolean 		True if when this was the last DiscoveryAccess for an endpoint it was to be treated as dark space
Not shown in UI
#_last_interesting : boolean 		True if this is the last DiscoveryAccess which accessed an endpoint
Session Establishment Duration
discovery_duration : int 		The amount of time taken to establish a session with the endpoint
Total Discovery Duration
discovery_duration_sum : int 		The amount of time spent interacting with the endpoint including session establishment
Not shown in UI
#access_failure : boolean 		True if there are session failures linked to this DiscoveryAccess
Not shown in UI
#access_success : string 		The session type and credential used
Not shown in UI
#_consolidation_done : list:string 		List of the consolidation appliance identifiers this DA has been be sent to
Retrieved by Scanning Appliance
is_consolidation : boolean 		If present, always has the value True, and indicates that the data for this DiscoveryAccess originated from a scanning appliance before being consolidated on this one
Inferred Sync Consolidation
is_sync : boolean 		If present, always has the value True, and indicates that the data for this DiscoveryAccess originated from an inferred sync consolidation sender
Inferred Sync Consolidation Sender Id
sync_sender_id : string 		Identifier of inferred sync consolidation sender
Inferred Sync Consolidation Sender
sync_sender_name : string 		Name of inferred sync consolidation sender
Inferred Sync Consolidation Node Id
sync_sender_node_id : string 		Hex node id on inferred sync consolidation sender
No Response Count
no_response_count : int 		The number of no response DAs suppressed onto a single no response DA
Last Response Time
last_response : date 		The date of the last response DA
Discovered From Scanner File
is_scanner_file : boolean 		True if this data came from a scanner file
Best IP Score
best_ip_score : int 		Best IP score used by endpoint optimisation
Scanned Indirectly
scanned_indirectly : string 		Method used to indirectly scan endpoint
Cloud Provider
provider : string 		Code of cloud or API provider
Cloud Region
region : string 		Code of cloud region

Relationships of the DiscoveryAccess node

The relationships of the DiscoveryAccess node are described in the following table:

UI Name Relationship Description 
Failed Host DiscoveryAccess:
AccessFailure:
InferredElement:
Host 		Probable Host for a failed access
Failed MF Part DiscoveryAccess:
AccessFailure:
InferredElement:
MFPart 		Probable MF Part for a failed access
Failed Management Controller DiscoveryAccess:
AccessFailure:
InferredElement:
ManagementController 		Probable Management Controller for a failed access
Failed Network Device DiscoveryAccess:
AccessFailure:
InferredElement:
NetworkDevice 		Probable Network Device for a failed access
Failed Printer DiscoveryAccess:
AccessFailure:
InferredElement:
Printer 		Probable Printer for a failed access
Failed SNMP Managed Device DiscoveryAccess:
AccessFailure:
InferredElement:
SNMPManagedDevice 		Probable SNMP Managed Device for a failed access
Failed Storage Device DiscoveryAccess:
AccessFailure:
InferredElement:
StorageDevice 		Probable Storage Device for a failed access
Optimized Host DiscoveryAccess:
AccessOptimization:
InferredElement:
Host 		Host corresponding to an access that was optimized away
Optimized MF Part DiscoveryAccess:
AccessOptimization:
InferredElement:
MFPart 		MF Part corresponding to an access that was optimized away
Optimized Management Controller DiscoveryAccess:
AccessOptimization:
InferredElement:
ManagementController 		Management Controller corresponding to an access that was optimized away
Optimized Network Device DiscoveryAccess:
AccessOptimization:
InferredElement:
NetworkDevice 		Network Device corresponding to an access that was optimized away
Optimized Printer DiscoveryAccess:
AccessOptimization:
InferredElement:
Printer 		Printer corresponding to an access that was optimized away
Optimized SNMP Managed Device DiscoveryAccess:
AccessOptimization:
InferredElement:
SNMPManagedDevice 		SNMP Managed Device corresponding to an access that was optimized away
Optimized Storage Device DiscoveryAccess:
AccessOptimization:
InferredElement:
StorageDevice 		Storage Device corresponding to an access that was optimized away
Container DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
ContainerInfo 		Container
Device Info DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DeviceInfo 		Device Info
DDD List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DirectlyDiscoveredList 		DDD List
Directory Listing DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DirectoryListing 		Directory Listing
Discovered API Provider Result List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredAPIProviderResultList 		Discovered API Provider Result List
Discovered API Result DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredAPIResult 		Discovered API Result
Discovered API Result List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredAPIResultList 		Discovered API Result List
Discovered Application Component List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredApplicationComponentList 		Discovered Application Component List
Discovered Card List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredCardList 		Discovered Card List
Discovered Certificate DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredCertificate 		Discovered Certificate
Discovered Chassis List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredChassisList 		Discovered Chassis List
Discovered Cloud API Result List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredCloudAPIResultList 		Discovered Cloud API Result List
Discovered Command Result DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredCommandResult 		Discovered Command Result
Discovered Coupling Facility List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredCouplingFacilityList 		Discovered Coupling Facility List
Discovered DNS Detail DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredDNSDetail 		Discovered DNS Detail
Discovered Database Detail List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredDatabaseDetailList 		Discovered Database Detail List
Discovered Database List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredDatabaseList 		Discovered Database List
Discovered Dependency List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredDependencyList 		Discovered Dependency List
Discovered Disk Drive List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredDiskDriveList 		Discovered Disk Drive List
Discovered File DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredFile 		Discovered File
Discovered IP Address List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredIPAddressList 		Discovered IP Address List
Discovered MAC Addresses DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredMACAddresses 		Discovered MAC Addresses
Discovered MFPart List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredMFPartList 		Discovered MFPart List
Discovered MQ Detail List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredMQDetailList 		Discovered MQ Detail List
Discovered Mainframe List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredMainframeList 		Discovered Mainframe List
Discovered Mainframe View Result List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredMainframeViewResultList 		Discovered Mainframe View Result List
Discovered Managed Device List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredManagedDeviceList 		Discovered Managed Device List
Discovered Network Interface List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredNetworkInterfaceList 		Discovered Network Interface List
Discovered OS Namespace List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredOSNamespaceList 		Discovered OS Namespace List
Discovered Packages DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredPackages 		Discovered Packages
Discovered Patches DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredPatches 		Discovered Patches
Discovered Program List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredProgramList 		Discovered Program List
Discovered Registry Value DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredRegistryValue 		Discovered Registry Value
Discovered SNMP Values DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSNMP 		Discovered SNMP Values
Discovered SNMP Table DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSNMPTable 		Discovered SNMP Table
SQL Query Result DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSQLQuery 		SQL Query Result
Discovered Software List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSoftwareList 		Discovered Software List
Discovered Storage Subsystem List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredStorageSubsystemList 		Discovered Storage Subsystem List
Discovered Sysplex List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSysplexList 		Discovered Sysplex List
Discovered Tape Drive List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredTapeDriveList 		Discovered Tape Drive List
Discovered Transaction List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredTransactionList 		Discovered Transaction List
Discovered WBEM Association DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWBEMAssociators 		Discovered WBEM Association
Discovered WBEM Enumerate Instances DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWBEMEnumInstances 		Discovered WBEM Enumerate Instances
Discovered WBEM Query DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWBEMQuery 		Discovered WBEM Query
Discovered WMI Query DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWMIQuery 		Discovered WMI Query
FQDN List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
FQDNList 		FQDN List
File System List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
FileSystemList 		File System List
HBA Info List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
HBAInfoList 		HBA Info List
Host Info DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
HostInfo 		Host Info
Integration Result DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
IntegrationResult 		Integration Result
Network Connection List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
NetworkConnectionList 		Network Connection List
Process List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
ProcessList 		Process List
Registry Listing DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
RegistryListing 		Registry Listing
Service List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
ServiceList 		Service List
Virtual Machine List DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
VirtualMachineList 		Virtual Machine List
Endpoint DiscoveryAccess:
Endpoint:
Endpoint:
Endpoint 		Endpoint
Caused Implicit Scans ExplicitEndpoint:
ImplicitScan:
ImplicitEndpoint:
DiscoveryAccess 		Implicitly scanned endpoints due to this access
Reason for Implicit Scan ImplicitEndpoint:
ImplicitScan:
ExplicitEndpoint:
DiscoveryAccess 		Access which caused this endpoint to be implicitly scanned
Host Associate:
Inference:
InferredElement:
Host 		Host inferred from this access
MF Part Associate:
Inference:
InferredElement:
MFPart 		MF Part inferred from this access
Mainframe Associate:
Inference:
InferredElement:
Mainframe 		Mainframe inferred from this access
Management Controller Associate:
Inference:
InferredElement:
ManagementController 		Management Controller inferred from this access
Network Device Associate:
Inference:
InferredElement:
NetworkDevice 		Network Device inferred from this access
Printer Associate:
Inference:
InferredElement:
Printer 		Printer inferred from this access
SNMP Managed Device Associate:
Inference:
InferredElement:
SNMPManagedDevice 		SNMP Managed Device inferred from this access
Storage Device Associate:
Inference:
InferredElement:
StorageDevice 		Storage Device inferred from this access
Provider Accesses List:
List:
Member:
ProviderAccess 		Provider Accesses (deprecated)
Discovery Run Member:
List:
List:
DiscoveryRun 		Discovery Run
Pattern Execution Member:
List:
List:
PatternExecution 		Pattern Execution
Session Log ItemWithLog:
Log:
Log:
SessionLog 		Session Log for this Discovery Access
Session Results DiscoveryAccess:
Metadata:
Detail:
SessionResult 		Session Results
Requested by DDD List DiscoveryAccess:
Request:
RequestSource:
DirectlyDiscoveredList 		DDD List that requested this Discovery Access
Requested by Discovered API Result DiscoveryAccess:
Request:
RequestSource:
DiscoveredAPIResult 		Discovered API Result that requested this Discovery Access
Requested by Discovered Certificate DiscoveryAccess:
Request:
RequestSource:
DiscoveredCertificate 		Discovered Certificate that requested this Discovery Access
Requested by Discovered Command Result DiscoveryAccess:
Request:
RequestSource:
DiscoveredCommandResult 		Discovered Command Result that requested this Discovery Access
Requested by Discovered DNS Detail DiscoveryAccess:
Request:
RequestSource:
DiscoveredDNSDetail 		Discovered DNS Detail that requested this Discovery Access
Requested by Discovered File DiscoveryAccess:
Request:
RequestSource:
DiscoveredFile 		Discovered File that requested this Discovery Access
Requested by Discovered Registry Value DiscoveryAccess:
Request:
RequestSource:
DiscoveredRegistryValue 		Discovered Registry Value that requested this Discovery Access
Requested by Discovered SNMP Values DiscoveryAccess:
Request:
RequestSource:
DiscoveredSNMP 		Discovered SNMP Values that requested this Discovery Access
DDD List on Another Device RequestSource:
Request:
DiscoveryResult:
DirectlyDiscoveredList 		DDD List on another device
Directory Listing on Another Device RequestSource:
Request:
DiscoveryResult:
DirectoryListing 		Directory Listing on another device
Discovered API Result on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredAPIResult 		Discovered API Result on another device
Discovered API Result List on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredAPIResultList 		Discovered API Result List on another device
Discovered Command Result on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredCommandResult 		Discovered Command Result on another device
Discovered DNS Detail on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredDNSDetail 		Discovered DNS Detail on another device
Discovered File on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredFile 		Discovered File on another device
Discovered Registry Value on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredRegistryValue 		Discovered Registry Value on another device
Discovered SNMP Values on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredSNMP 		Discovered SNMP Values on another device
Discovered SNMP Table on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredSNMPTable 		Discovered SNMP Table on another device
SQL Query Result on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredSQLQuery 		SQL Query Result on another device
Discovered WBEM Association on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredWBEMAssociators 		Discovered WBEM Association on another device
Discovered WBEM Enumerate Instances on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredWBEMEnumInstances 		Discovered WBEM Enumerate Instances on another device
Discovered WBEM Query on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredWBEMQuery 		Discovered WBEM Query on another device
Discovered WMI Query on Another Device RequestSource:
Request:
DiscoveryResult:
DiscoveredWMIQuery 		Discovered WMI Query on another device
File System List on Another Device RequestSource:
Request:
DiscoveryResult:
FileSystemList 		File System List on another device
Registry Listing on Another Device RequestSource:
Request:
DiscoveryResult:
RegistryListing 		Registry Listing on another device
Previous Discovery Access Next:
Sequential:
Previous:
DiscoveryAccess 		Previous Discovery Access
Next Discovery Access Previous:
Sequential:
Next:
DiscoveryAccess 		Next Discovery Access
Errors ElementWithStatus:
Status:
Status:
ECAError 		Errors detected by the ECA engine

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*