Configuration
From PortSensor Wiki
Contents |
Server
Log in to your PortSensor Server.
Configuring Devices
A device profile groups sensor metrics from any number of reporting monitors. There are no fixed rules about what constitutes a device in PortSensor. Devices may be hardware-related (e.g. servers, switches), software-related (e.g. helpdesk) or abstract (e.g. Sales Team).
- Setup->Devices
- Click Add New Device
- Device Name: A descriptive name for this device, such as "Phobos (Web Server)"
- Device ID: This is the unique nickname for this device that will be used by monitors when providing updates. An ID should be short, lowercase and alphanumeric (periods and underscores OK) with no spaces. For example: "phobos.server"
- Click Save Changes
Configuring Monitors
Monitors do the actual work of gathering and reporting sensor metrics for devices to the Server. The monitor profiles configured in the server provide each monitor with a login.
- Setup->Monitors
- Click Add New Monitor
- Monitor Name: A descriptive name for this monitor, such as "Phobos Monitor"
- Monitor ID: This is the unique name for this monitor that will be used to send updates to the server. An ID should be short, lowercase and alphanumeric (periods and underscores OK) with no spaces. For example: "phobos.monitor"
- Monitor Password: A password will be auto-generated for you. This and the Monitor ID are used by a monitor to authenticate when reporting updates.
- M.I.A. (secs): The sensors from this monitor will be considered "Missing In Action" (M.I.A.) if this number of seconds passes without receiving an update. This should be set high enough to allow the monitor to run in addition to your waiting interval, but not so high that you're the last to know if the monitoring process goes down with a server. A good default is 300 seconds (5 minutes) if a monitor is updating every 1-2 minutes. A value of 0 disables the M.I.A. feature.
- Click Save Changes
Configuring Feeds
Feeds provide sensor information from devices to viewers. A viewer is any application that makes use of this data, such as the PortSensor Desktop Viewer. The feed output is simple XML which can be easily parsed by most programming languages.
- Setup->Feeds
- Click Add New Feed
- Feed Name: A descriptive name for this feed, such as "West Coast Datacenter"
- Feed ID: This is the unique name for this feed that will be used when requesting the feed from the server or to log in to the server with a web-browser. An ID should be short, lowercase and alphanumeric (periods and underscores OK) with no spaces. For example: "west_coast_dc"
- Feed Password: This is an optional password that will need to be provided by viewers to request this feed. To create a publicly-accessible feed leave this blank.
- Feed Devices: The sensor metrics from these devices will be included in the feed.
- Click Save Changes
