TrueSight API Documentation
OverviewAccountActionsAdministration
Alarms v1Alarms v2BatchingDashboards
DatasetsEventsExtended Metrics
GroupsHostgroupsMetersMetricsProduct
PluginsRelaysSourcesSource-TagsSynchronize Data
Tenants
Terms

POST/v1/meter/:meterName/registration

Register a Meter with TrueSight Pulse

Add in meta data about the system hosting the meter. We use this metadata for support issues and to help with our roadmap.

Request body properties

meterVersion

What version of the Meter is running, ex. "3.0.0-1"

hostname

What is the hostname of the meter, ex. "ubuntu14"

mach

Machine Type, ex. "x86_64"

machdesc

Machine Description, ex. "Ubuntu 14.04 LTS" or "Microsoft Windows 2008"

osver

OS Kernel Version, ex, "3.2.0-64-virtual" or "6.1"

osname

Name of the Operating System, ex. "Linux" or "Win32"

arch

Machine Architecture, ex. "x86_64" or "x86"

vendname

OS Vendor Name, ex. "Linux" or "Microsoft"

version

OS Version, ex "12.04" or "2008"

patch

OS Patch, ex. "unknown" or "Service Pack 1"

cpus

CPU Information

memory

Memory Information

filesystems

Filesystem Information

interfaces

Networking Interfaces

Example request:

curl https://api.truesight.bmc.com/v1/meter/:meterName/registration \
-X POST \
-u <email>:<api-token> \
-H "Content-Type: application/json" \
-d '
{
   "meterVersion": "3.0.0-1",
   "hostname": "ubuntu14",
   "mach": "x86_64",
   "osver": "#46-Ubuntu SMP Thu Apr 10 19:11:08 UTC 2014",
   "machdesc": "Ubuntu 14.04 LTS",
   "osname": "Linux",
   "arch": "x86_64",
   "version": "3.13.0-24-generic",
   "vendname": "Linux",
   "patch": "unknown",
   "cpus": [
      {
         "vendor": "Intel",
         "model": "Core i7-3740QM CPU @ 2.70GHz",
         "mhz": 2696,
         "cacheSize": 6144,
         "totalSockets": 1,
         "totalCores": 1,
         "coresPerSocket": 1
      }
   ],
   "memory": {
      "usable": 8380219392,
      "installed": 8373436416
   },
   "filesystems": [
      {
         "dirName": "/",
         "devName": "/dev/sda1",
         "typeName": "local",
         "sysTypeName": "ext4"
      },
      {
         "dirName": "/home/davidc/development",
         "devName": "192.168.56.1:/Users/davidc/development",
         "typeName": "remote",
         "sysTypeName": "nfs"
      }
   ],
   "interfaces": [
      {
         "name": "lo",
         "type": "Local Loopback",
         "mtu": 65536,
         "ether": "00:00:00:00:00:00",
         "addrs": [
            "127.0.0.1/8",
            "::1"
         ],
         "flags": [
            "UP",
            "LOOPBACK",
            "RUNNING"
         ]
      },
      {
         "name": "eth0",
         "type": "Ethernet",
         "mtu": 1500,
         "ether": "08:00:27:18:a9:9a",
         "addrs": [
            "10.0.2.15/16",
            "fe80::a00:27ff:fe18:a99a"
         ],
         "flags": [
            "UP",
            "BROADCAST",
            "RUNNING",
            "MULTICAST"
         ]
      },
      {
         "name": "eth1",
         "type": "Ethernet",
         "mtu": 1500,
         "ether": "08:00:27:54:18:f0",
         "addrs": [
            "192.168.56.104/16",
            "fe80::a00:27ff:fe54:18f0"
         ],
         "flags": [
            "UP",
            "BROADCAST",
            "RUNNING",
            "MULTICAST"
         ]
      }
   ]
}'

Example reponse:

{
   "success": true
}