Software Container node

A Software Container node represents an instance of a software container, such as a Docker container, running in the environment. Software Container nodes represent the containers, rather than any management software such as the Docker Engine. The Docker Engine and its equivalent for other providers is modeled using an SI.

Software containers are not synchronized to the CMDB

The transient nature and purpose of software containers means that synchronizing them might cause excessive churn in the CMDB. However, to ensure that the CMDB reflects the state of the container software configuration, the related SIs, load balancers, and deployment information are synchronized as usual. 

Software Container node lifecycle

The following section describes the scenarios in which a Software Container node is created, updated or destroyed.

Creation

Software Container nodes are created by patterns which trigger on an SI representing container management software, such as the Docker Engine. When such a pattern triggers, it requests information on the containers that the management software is running. A Software Container node is created for each container reported by the management software.

AIX Application WPARs are also modeled using Software Container nodes. In this case, the pattern triggers on hostinfo. 

Update and removal

Software Container nodes are updated when patterns request information from the container management software. A Software Container node is:

  • Updated for each existing container reported by the management software.
  • Removed where previously existing containers are no longer reported by the management software. This is an Authoritative Removal type, see Authoritative Removal.

Software Container node attributes

The attributes of a Software Container node are as described in the following table:

UI Name
Attribute Name and Type

Description

Name
name string

Name of the Software Container.

Short Name
short_name string

Short name of the Software Container.

Type
type string

Type of the Software Container.

Instance Count
count int

Number of containers grouped together.

Image
image string

Container image name.

Tag
tag string

Container tag.

Digest
digest string

Container digest.


key string

Globally unique key.

Cloud Hosted
cloud boolean

When set, this flag indicates that the Software container runs directly on a cloud service.

Cloud Class
cloud_class string

Vendor classification of cloud software.

Publisher
publisher string

The publisher of the Software Container. Only populated in cases that a Pattern identifies products from more than one publisher. This information is normally found in the Pattern node's publishers attribute.

Product Name
product string

The product name. Only populated in cases that a Pattern identifies more than one product. This information is normally found in the Pattern node's products attribute.

Full Version
version string

Full-resolution version.

Product Version
product_version string

Version publicised by the vendor.

Release
release string

Release number.

Edition
edition string

Edition.

Service Pack
service_pack string

Service pack.

Build
build string

Build number.

Patch
patch string

Patch level.

Revision
revision string

Revision.


listening_ports list:int

Ports this container is configured to listen on.


age_count int

The number of consecutive successful (positive) or failed (negative) times the Software Container has been seen during host scans.


last_update_success date

The time at which a scan was last successfully associated with this Software Container.


last_update_failure date

The time at which a scan associated with this Software Container failed.


_explicit_removal _string

Pattern that has taken over removal in place of standard removal.

Shared flag override
shared _boolean

When set, this flag indicates that the Software Container should always be regarded as shared or not shared for purposes of visualization and application modelling. This is a user controlled flag.

Tags
tag_set dictionary

Tag set.

Software Container node relationships

The relationships on a Software Container node are as described in the following table:

UI Name

Relationship

Description

Host

SoftwareContainer:
RunningSoftware:
HostedSoftware:
Host:
Host

Host on which this Software Container is running.

MFPart

SoftwareContainer:
RunningSoftware:
HostedSoftware:
Host:
MFPart

MFPart on which this Software Container is running.

Cloud Service

SoftwareContainer:
RunningSoftware:
HostedSoftware:
Host:
CloudService

Cloud Service on which this Software Container is running.

Deployments

SoftwareContainer:
Member:
Collection:
Collection:
Deployment

A deployment which this Software Container is a member of.

Maintaining Pattern

SoftwareContainer:
Element:
Maintainer:
Pattern:
Pattern

Pattern that is maintaining this Software Container.

Contains Software Instances

SoftwareContainer:
{{SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
SoftwareInstance

Software instances running in this Software Container.

Software Support Details

SoftwareContainer:
ElementWithDetail:
SupportDetail:
SoftwareDetail:
SupportDetail

Software Support Detail related to this Software Container.

Files

SoftwareContainer:
ElementUsingFile:
RelatedFile:
File:
File

Files used by this Software Container.

Details

SoftwareContainer:
ElementWithDetail:
Detail:
Detail:
Detail

Details of this Software Container.

Collections

SoftwareContainer:
Member:
Collection:
Collection:
Collection

A collection which this Software Container is a member of.

Administrative Collections

SoftwareContainer:
Member:
Collection:
Collection:
AdminCollection

An administrative collection which this Software Container is a member of.

Load Balancer

SoftwareContainer:
ServiceProvider:
SoftwareService:
Service:
LoadBalancerMember

SoftwareContainer implementing a load balanced service.

Managed by Software Instance

SoftwareContainer:
ManagedElement:
Management:
Manager:
SoftwareInstance

Software Instances that manage this Software Container.

Hosting Cluster

SoftwareContainer:
RunningSoftware:
HostedSoftware:
Host:
Cluster

Cluster on which this clustered Software Container is running.

Server Software Instances

SoftwareContainer:
Client:
Communication:
Server:
SoftwareInstance

Server Software Instances that this Software Container is communicating with.

Client Software Instances

SoftwareContainer:
Server:
Communication:
Client:
SoftwareInstance

Client Software Instances that are communicating with this Software Container.

Communicating Peer Software Instances

SoftwareContainer:
Peer:
Communication:
Peer:
SoftwareInstance

Peer Software Instances that are communicating with this Software Container.

Server Software Components

SoftwareContainer:
Client:
Communication:
Server:
SoftwareComponent

Server Software Components that this Software Container is communicating with.

Client Software Components

SoftwareContainer:
Server:
Communication:
Client:
SoftwareComponent

Client Software Components that are communicating with this Software Container.

Communicating Peer Software Components

SoftwareContainer:
Peer:
Communication:
Peer:
SoftwareComponent

Peer Software Components that are communicating with this Software Instance.

Databases

SoftwareContainer:
Client:
Communication:
Server:
Database

Databases that this Software Container is a client of.

Client to Load Balancer Service

SoftwareContainer:
Client:
Communication:
Server:
LoadBalancerService

Load Balancer Services that this Software Instance is communicating with.

Observed Communication to Load Balancer Service

SoftwareContainer:
Connecting:
ObservedCommunication:
Listening:
LoadBalancerService

Load Balancer Services that this Software Instance is observed to be communicating with.

Observed incoming connections

SoftwareContainer:
Listening:
ObservedCommunication:
Connecting:
SoftwareInstance

Software Instances observed to be connecting to this container.

Observed outgoing connections

SoftwareContainer:
Connecting:
ObservedCommunication:
Listening:
SoftwareInstance

Software Instances this container is observed connecting to.

Observed connections

SoftwareContainer:
Peer:
ObservedCommunication:
Peer:
SoftwareInstance

Software Instances observed communicating with this container.

Observed incoming connections from candidate SIs

SoftwareContainer:
Listening:
ObservedCommunication:
Connecting:
CandidateSoftwareInstance

Candidate Software Instances observed to be connecting to this container.

Observed outgoing connections to candidate SIs

SoftwareContainer:
Connecting:
ObservedCommunication:
Listening:
CandidateSoftwareInstance

Candidate Software Instances this container is observed connecting to.

Observed connections with candidate SIs

SoftwareContainer:
Peer:
ObservedCommunication:
Peer:
CandidateSoftwareInstance

Candidate Software Instances observed communicating with this container.

Observed incoming connections from unassigned connections

SoftwareContainer:
Listening:
ObservedCommunication:
Connecting:
UnassignedConnections

Unassigned Connections to this Software Container.

Observed outgoing connections to unassigned ports

SoftwareContainer:
Connecting:
ObservedCommunication:
Listening:
UnassignedConnections

Unassigned Connections that this Software Container is observed connecting to.

Observed connections with unassigned connections

SoftwareContainer:
Peer:
ObservedCommunication:
Peer:
UnassignedConnections

Unassigned Connections observed communicating with this Software Container.

Primary processes

SoftwareContainer:
InferredElement:
Inference:
Primary:
DiscoveredProcess

Discovered process from which the existence of this Software Container was inferred.

Contributor processes

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredProcess

Discovered process from which one or more attributes of this Software Container were inferred.

Associated processes

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredProcess

Discovered process related in some way to this Software Container.

Associated services

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredService

Discovered service related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredNetworkConnectio

Discovered network connection from which one or more attributes of this Software Container were inferred.

Associated network connections

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredNetworkConnection

Discovered network connection related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Primary:
DiscoveredListeningPor

Discovered listening port from which the existence of this Software Container was inferred.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredListeningPor

Discovered listening port from which one or more attributes of this Software Container were inferred.

Associated listening ports

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredListeningPort

Discovered listening port related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
Packag

Package from which one or more attributes of this Software Container were inferred.

Associated packages

SoftwareContainer:
InferredElement:
Inference:
Associate:
Package

Package related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
Hos

Host from which one or more attributes of this Software Container were inferred.

SoftwareContainer:
InferredElement:
Inference:
Associate:
Hos

Host related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Primary:
DiscoveredFil

Discovered file from which the existence of this Software Container was inferred.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredFil

Discovered file from which one or more attributes of this Software Container were inferred.

Associated files

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredFile

Discovered file related in some way to this Software Container.

Primary software

SoftwareContainer:
InferredElement:
Inference:
Primary:
DiscoveredSoftware

Discovered software from which the existence of this Software Container was inferred.

Contributor software

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredSoftware

Discovered software from which one or more attributes of this Software Container were inferred.

Associated discovered software

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredSoftware

Discovered software related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredCommandResul

Discovered command result from which one or more attributes of this Software Container were inferred.

Associated command results

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredCommandResult

Discovered command result related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredRegistryValu

Discovered Windows Registry value from which one or more attributes of this Software Container were inferred.

Associated registry values

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredRegistryValue

Discovered Windows Registry value related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredWM

Discovered WMI query result from which one or more attributes of this Software Container were inferred.

Associated WMI values

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredWMI

Discovered WMI query result related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredWBEMInstanc

Discovered WBEM instance from which one or more attributes of this Software Container were inferred.

Associated WBEM instances

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredWBEMInstance

Discovered WBEM instance related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredWBEMQueryResul

Discovered WBEM result from which one or more attributes of this Software Container were inferred.

Associated WBEM query results

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredWBEMQueryResult

Discovered WBEM result related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredWBEMAssociatorsResul

Discovered WBEM association from which one or more attributes of this Software Container were inferred.

Associated associators results

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredWBEMAssociatorsResult

Discovered WBEM association related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredAPIResul

Discovered API call result from which one or more attributes of this Software Container were inferred.

Associated API call results

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredAPIResult

Discovered API call result related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
Patter

Pattern from which one or more attributes of this Software Container were inferred.

SoftwareContainer:
InferredElement:
Inference:
Primary:
SoftwareInstanc

Software instance from which the existence of this Software Container was inferred.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
SoftwareInstanc

Software instance from which one or more attributes of this Software Container were inferred.

Associated Software

SoftwareContainer:
InferredElement:
Inference:
Associate:
SoftwareInstance

Software instance related in some way to this Software Container.

SoftwareContainer:
InferredElement:
Inference:
Primary:
MFPar

MFPart from which the existence of this Software Container was inferred.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
MFPar

MFPart from which one or more attributes of this Software Container were inferred.

SoftwareContainer:
InferredElement:
Inference:
Contributor:
DiscoveredDNSDetai

Resolved DNS details from which one or more attributes of this Software Container were inferred.

Associated DNS details

SoftwareContainer:
InferredElement:
Inference:
Associate:
DiscoveredDNSDetail

Resolved DNS details related in some way to this Software Container.

SoftwareContainer node expression

The expression provided on a SoftwareContainer node is described in the table below.

UI Name

Expression

Description

Host

host_link : nodeLink(#RunningSoftware:HostedSoftware:Host:,#RunningSoftware:HostedSoftware:Host:.name)

Link to host.

Was this page helpful? Yes No Submitting... Thank you

Comments