Skip to main content
Matrix42 Self-Service Help Center

Configuration Items

How to create and manage configuration items (CIs) throughout their lifecycle.

Overview

Configuration Items (CI) are any asset, devices, platform, or software on your network that FireScope SDDM will discover (e.g. servers, routers, VMs, applications). They can be grouped into a Logical Group or a Service Group. CIs contain Attributes which are the metrics or logs you want to track (e.g., Processor Utilization, Free Disk Space, log entries). Each CI can be connected with FireScope SDDM using an optional agent or through SNMP, Syslog, or other communication methods.

CI’s Association with Credentials

Credentials allow a Configuration Item to gather information from your environment without loading or enabling additional agents and services. Depending on your environment, valid credentials may be required. Use the Manage Credentials page Configuration > Connection Credentials to add or update credentials. Credentials are Edge device specific. This allows you to designate shared credentials (such as SNMP) per environment with a dedicated Edge device.

Each discovered asset includes key elements: 

  1. The Configuration Item – The CI acts as a container that identifies the IP Address or FQDN of the asset.
  2. Attributes – Attributes are the individual metrics, logs, and operational states of the CI.

Please note that this section describes the manual process for creating an individual CI and is rarely followed.  In most cases, CIs are created automatically using Discovery, Integration or the Configuration Web Service.  Additionally, Attributes are ideally applied via Blueprints in any scenario where you have more than one of a given class of CI.

Create CI

Following are the steps to create CIs manually.  Log in to FireScope SDDM as a FireScope or Account Administrator.

  1. Click Configuration > Configuration Items > Create and the New Configuration Item page will be displayed. 
clipboard_e785a1ff8f15f5db2f5d96ff8f19f95ab.png

Details

  1. Name: Enter a descriptive name for this item.
  2. Enable Monitoring: Select this if you want to enable monitoring for this item.

Connection

  1. Edge Device: Select an Edge Device to designate the data collection or operation target. Edge Device is the main connection point that is required for FireScope SDDM to collect data from this CI. This is server (or VM) that is connected to the FireScope SDDM cloud application but is local to your CIs that are monitored
  2. Connect Via: Select how FireScope should connect to the CI, from the drop-down list. Note: IP address is faster since it doesn’t require a DNS lookup process.
  3. IP Address: Enter IP address of the asset. This field is required only if you have selected IP Address from the Connect to list.
  4. Domain Name: Enter the domain name of the asset. This field is required only if you have selected Domain Name from the Connect to list.
  5. Port: Enter the port the agent is listening on. This field is required only if you are using the FireScope Agent, which by default uses port 8042.

Connections to Device API for Data Collection

Linking a CI to stored credentials will allow attributes within this CI to connect to the device and collect data. Depending on the type of attribute used (SNMP, LDAP, NetApp, etc), you must provide the right type of credential. For example, to use the VM attributes, such as “vm_guest_cpu_host_util” will require connectivity to the VMWare API to collect this metric. The CI must have the reference link to the VM connection credential.  Select one of the Credential connections from the list shown on the horizontal bar.

  1. Amazon AWS Credential:  An AWS credential allows SDDM to connect to your AWS environment.  You will be required to supply a Region Endpoint, an Access Key ID and a Secret Access Key.
  2. LDAP Connection: A LDAP access credentials allow attributes to connect to the LDAP service. User must provide login as well as binding information. Use with “ldap_check” attributes.
  3. NetApp ONTAP: This access credentials allow attributes to connect directly to the NetApp device and determine data relationships. Use with NetApp Check attribute type. (Ex. “netapp_perf”)
  4. SNMP Credential: SNMP access credentials allow attributes to connect to the SNMP enabled devices. User must provide community
  5. SSH: SSH Access Credential allows you to connect to your Device via SSH.  You will be required to supply a Username and Password and a Passphrase (if required)
  6. VMware Virtual Center Connection: A CI associated with a Virtual Center connection has the ability to gather Host and Guest information from your Virtual Environment (vCenter) without loading or enabling additional agents and services. This feature could also be used to gather capacity information across your virtual infrastructure. Virtual Center Infrastructure Client Name – used as the unique lookup to locate the associated virtual center host or guest. Use with VM Center, Host and Guest attributes.
  7. WMI:  Allows you to connect to Active Directory via WMI.  You are required to supply a Username and a Password.

Select Blueprints and the Blueprints page will be displayed.

clipboard_e52759c443546fe5f6270dd435d61567c.png

Linked Blueprints: Click on the Edit button to select blueprints to apply to this CI. Blueprints are already configured with attributes (data collection).  When you link a blueprint to a CI, that CI inherits all defined blueprint elements and can be managed via the linkage. This is a quick way to start collecting data with your configuration.

Select Network Discovery and the Network Discovery page will be displayed.

clipboard_ea101517e912145a3601db46ababd53ff.png
  • Device Inventory Blueprint: Click on the edit button to select a blueprint. The Blueprint linked to this CI will try to expand dynamic elements with appropriate macros.
  • Run Discovery Job: Select this to immediately run the Discovery Job after it is saved.
  • SNMP Credentials: SNMP access credentials allows attributes to connect to the SNMP device.
  • NetApp ONTAP Credential: NetApp ONTAP access credentials allows attributes to connect to the NetApp device and determine data relationships.
  • SSH Credentials:  Allows you to connect to servers in your environment via SSH
  • WMI Credentials:  Allows you to connect to your Active Directory environment.

Select Inventory and the Inventory page will be displayed.

clipboard_e06b9ea4daa04d8c851083a32d51ccb3f.png

For Configuration Items that have been previously scanned by FireScope SDDM this page will display all of the details that FireScope knows about this Configuration Item

CMDB Inventory Fields

  • Last Seen – The last time FireScope scanned this Configuration Item
  • Primary Layer – This is the type of function a CI supports in your defined service. For example, your network fileserver CIs for your CRM system should have the stack layer of STORAGE. In various views throughout the application, we will use this identifier to help indicate your issues.
  • Secondary Layer –
  • Configuration Item Type – CI Types let you classify Configuration Items for reporting and other view filters
  • Asset Type – lower level of CI/device type so for example you have CI type of network the you could have an asset type pf router or switch.
  • Alternate Name
  • Architecture
  • Contact
  • Hardware
  • Installed Software
  • Knowledge Base URL
  • Location
  • MAC Address
  • Manufacturer
  • Model
  • Notes
  • Operating System
  • Operating System Distribution
  • Operating System Version
  • Serial Number
  • Tag
  • Total Ram (Bytes)

Select Group Membership and the Group Membership page will be displayed

clipboard_eb3ad800fe2d964213126258a38e06630.png

Groups Membership

  1. Service Group – Grouping of CIs based on functionality or service provided by CIs. User groups linked to a Service Group will allow users access to all Logical Groups, CIs and related elements (attributes) under that Service Group & its Logical Groups.
  2. Logical Group – Grouping of CIs based on location, type of hardware, or another common factor between CIs. User groups linked to a Logical Group will allow users access to all CIs and related elements (attributes) under that Logical Group.

List, Edit, View, Delete CI’s

Click Configuration > Configuration Items > List and the Configuration Item List page will be displayed. 

clipboard_e01c74e3affec7643b4c71128d9b52e26.png

Edit, View, Delete CI

  1. Find the Name of the CI you are interested in.
  2. Go to the far right of the row for that CI.
  3. Click the 3 dots at the end of that row.
  4. Select the appropriate action you would like to take.

CI Type Definition

CI Types let you classify Configuration Items for reporting and other view filters. You can edit defined types or add new types to be used.

  1. Click Configuration > Configuration Items > Types and the Configuration Item Types page will be displayed. 
clipboard_edfd51ccc3d552d9292b16c3491fee207.png

To Update CI Type

  1. Click on the existing CI Type Name and the CI Type form will be displayed.
  2. Make the necessary changes to the CI Type.
  3. Click the Save button.

To Create a new CI Type

  1. Click on the Create button + (plus sign in upper right of page) to create a new CI type and the Create CI Type page will be displayed.
clipboard_ed17c8538557040264aaa82c0ab226935.png
  • Was this article helpful?