×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')
BMC Helix Discovery ... Developing Node lifecycle DDD nodes

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 Helix 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 Helix 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 and relationships 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 IP address

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 have the value True and indicates that the data for this DiscoveryAccess originated from a scanning appliance before being consolidated on this one

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 provider

Cloud Region
region : string

Code of cloud region

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

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 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

Was this page helpful? Yes No Submitting... Thank you
Last modified by Duncan Tweed on Jun 27, 2022

Comments

Log in or register to comment.

Directory Listing node
Discovery Run node
© Copyright 2004 - 2023 BMC Software, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.