Data collected by Assets Discovery

Assets Discovery uses the protocols SSH, WMI, and SNMP to discover hosts and devices. In theory, all network connected machines that can communicate through one of these protocols can be discovered.

To assemble details information from a host or device, Assets Discovery needs instructions on how to do it. These instructions are specified in Patterns and Assets Discovery comes pre-packed with a set of patterns ready to use.

You can also write your own patterns if you have unusual assets to discover.

Default data types and devices

The Assets Discovery tool will discover the following:

SSH

WMI

SNMP

VMware vSphere

  • Linux/Unix based operating systems
  • AIX systems
  • Mac OS X operating systems
  • BSD operating systems
  • HP-UX systems
  • Novell Netware systems
  • Solaris systems

Microsoft Windows® 95
or later Microsoft operating systems

  • Network printers
  • IP cameras
  • Routers
  • Switches
  • Network Access Servers
  • Device: Printer
  • Device: Monitor
  • Device: USB Storage
  • Device: VideoController
  • ESXi hosts
  • Virtual guests

Platforms included in patterns

We've tested the following patterns with Assets Discovery:

Linux/Unix

Windows

SNMP

  • Ubuntu (>12.x)
  • CentOS (>6)
  • Debian (>7)
  • Red Hat (>6)
  • OpenSUSE (Tumbleweed)
  • Mac OS X (>10.x)
  • Solaris 11
  • Oracle Linux (>7)
  • Xen
  • Docker
  • Windows XP
  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2003
  • Windows Server 2008
  • Windows Server 2012
  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022
  • Docker
  • Axis IP Camera
  • Samsung IP Camera

Data collected and available extensions

For details on what kind of data is collected by Discovery and imported into Assets in Jira Service Management, see Discovery data imported to Assets.

You can extend the collected data for all Discovery-Objects by using an ExtendedInformation-Object (as described in the table below). This way, you can add extra information to your assets before they're imported to Assets in Jira Service Management.

Using the ExtendedInformation-Object

You can use the Extended Information Object to impact the Hash of the parent object by setting the attribute UseValueForObjectHash to true in a pattern.

Attribute

Type

Description

NameTEXT
TypeTEXTValid Types: Date, Boolean, Integer, String (default)
ValueTEXT

Using the object hash to define unique objects

In most of the collected objects by Assets Discovery, you can find an attribute called "Object Hash", which is used as a default Identifier for Assets in Jira Service Management.

These Object Hash Attributes define the Object as a unique object in Assets (for creating a new one or updating an existing one).

On the Assets Discovery side you can find an ObjectHashSetting.xml file, this file contains the definition of which attributes of the object will be used to build the unique hash.

Manipulations of this file will always have effects to your existing data in Assets.

For example:

If you set the value of <HostInfo_FirstNICMAC>true</HostInfo_FirstNICMAC> from true to false, the NetworkInterface-MAC-Address of the first available NIC will not longer used to build the Host-Hash.

All Host-Hashes will be new and importing the data will create new Host-Objects in Assets in Jira Service Management.

Analytics data collected by Discovery

The knowledge of how you use Discovery helps us improve the product and your experience. That’s why we’ve automated the collection of usage analytics, which you can turn off at any time. The data we collect includes information about the common settings, scanned system types, timing, and the features you use in Discovery.

We do not collect any personal information or user-generated data.

A Discovery admin can disable the analytics collection at any time.

Along with the feedback we get from you through Jira tickets, we’ll use the analytics to better understand friction areas and improve them quicker, as well as to detect potential bugs and fix them before they impact your work.

For more details, check our Privacy Policy, specifically the section ‘What information we collect about you’. You can also reference the End User Agreement to find out more.

How to manage data collection?

Data collection is turned of by default. A Discovery admin can opt in or out of data collection at any time.

To turn off data collection:

  1. In Discovery or the Collector, go to the Common tab.

  2. Clear the Send analytics checkbox.

How is data collected?

We use the Atlassian infrastructure to collect event data in Discovery. Analytics logs are stored locally and then periodically uploaded to a secure location.

What data do we collect?

We collect anonymous statistics about the operating system, application settings, data size and scanning performance, and others. We do not collect any personal information or user-generated data.

Here are some example events collected:

# operating system
jira.assets.discovery.scan.hosts.os.statistics | {"OSName":"Microsoft Windows 11 Pro","OSVersion":"10.0.22621","HostHash":"44C71A9E48236985DD313B8F36DBC05A"}
 
# application settings
jira.assets.discovery.settings.statistics | {"AgentIpRangeSet":"True","AgentScanInterval":"10","AgentTimeout":"3","AgentTokenSet":"True","AutoAddSudo":"False","DeleteBasicHosts":"True","DeleteDuplicateDevice":"False","DeleteUnknownHosts":"True","DeleteVMGuests":"False","ExportType":"FileCopy","MaxScanThreadTime":"10","NumberOfThreads":"7","PingRetry":"0","PingTimeout":"300","ServiceRestartInterval":"24","SNMPTimeout":"500","SSHTimeout":"40","TryVMGuestScan":"False","UsePowerShell":"False","Version":"7.0.1","WMITimeout":"25","VIMTimeout":"25","ScanSettingsCount":"5","EnabledPatternsCount":"74"}
 
# GUI performance
jira.assets.discovery.ui.performance | {"Action":"AgentList","ElapsedTimeInMilliseconds":"1899"}
 
# user's interaction with the app
jira.assets.discovery.view.visited | {"ViewName":"CommonSettings"}
jira.assets.discovery.button.click | {"ButtonName":"ViewAgents"}
 
# scan size and performance
jira.assets.discovery.collector.transfer | {"AgentsCount":"1","HostsCount":"12","DevicesCount":"0","ExportType":"Cloud"}
jira.assets.discovery.collector.transfer.time | {"ExportType":"Cloud","ExportTransferTimeInMilliseconds":"8043"}

Last modified on May 27, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.