README.md
author Katelyn Schiesser <kschiesser@laika.com>
Thu, 18 Apr 2019 11:59:38 -0700
changeset 21 58e70e52f817
parent 20 00a38d493f2c
child 25 6217282f6070
permissions -rw-r--r--
Added tag v0.6.0 for changeset 00a38d493f2c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
     1
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
     2
Arborist-SNMP
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
     3
=============
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
     4
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
     5
home
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
     6
: http://bitbucket.org/mahlon/Arborist-SNMP
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
     7
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
     8
code
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
     9
: http://code.martini.nu/Arborist-SNMP
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    10
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    11
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    12
Description
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    13
-----------
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    14
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    15
Arborist is a monitoring toolkit that follows the UNIX philosophy
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    16
of small parts and loose coupling for stability, reliability, and
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    17
customizability.
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    18
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    19
This adds various SNMP support to Arborist's monitoring, specifically
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    20
for OIDS involving:
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    21
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    22
 - Disk space capacity
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    23
 - System CPU utilization
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    24
 - Memory and swap usage
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    25
 - Running process checks
20
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
    26
 - UPS battery checks
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    27
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    28
It tries to provide sane defaults, while allowing fine grained settings
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    29
per resource node.  Both Windows and UCD-SNMP systems are supported.
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    30
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    31
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    32
Prerequisites
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    33
-------------
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    34
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    35
  * Ruby 2.3 or better
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    36
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    37
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    38
Installation
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    39
------------
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    40
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    41
    $ gem install arborist-snmp
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    42
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    43
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    44
Configuration
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    45
-------------
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    46
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    47
Global configuration overrides can be added to the Arborist config file,
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    48
under the `snmp` key.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    49
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    50
The defaults are as follows:
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
    51
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
    52
```
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
    53
arborist:
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
    54
  snmp:
17
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    55
    timeout: 2
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    56
    retries: 1
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    57
    community: public
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    58
    version: 2c
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    59
    port: 161
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    60
    batchsize: 25
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    61
    cpu:
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    62
      warn_at: 80
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    63
    disk:
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    64
      warn_at: 90
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    65
      include: 
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    66
      exclude:
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    67
      - "^/dev(/.+)?$"
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    68
      - "/dev$"
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    69
      - "^/net(/.+)?$"
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    70
      - "/proc$"
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    71
      - "^/run$"
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    72
      - "^/sys/"
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    73
      - "/sys$"
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    74
    processes:
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    75
      check: []
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    76
    memory:
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    77
      physical_warn_at: 
e4f0fd44734d Fix up the docs, make the default disk exclusion list more useful.
Mahlon E. Smith <mahlon@martini.nu>
parents: 15
diff changeset
    78
      swap_warn_at: 60
20
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
    79
    ups:
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
    80
      battery:
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
    81
        capacity_warn_at: 60
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
    82
        temperature_warn_at: 50
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
    83
```
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    84
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    85
The `warn_at` keys imply usage capacity as a percentage. ie:  "Warn me
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    86
when a disk mount point is at 90 percent utilization."
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    87
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    88
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    89
### Library Options
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    90
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    91
  * **timeout**: How long to wait for an SNMP response, in seconds?
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    92
  * **retries**: If an error occurs during SNMP communication, try again this many times before giving up.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    93
  * **community**: The SNMP community name for reading data.
14
d5cb8bd33170 Although faster, once aiming a few thousand nodes at net-snmp2 it leaks memory like a sieve. Use 'netsnmp' instead.
Mahlon E. Smith <mahlon@martini.nu>
parents: 11
diff changeset
    94
  * **version**: The SNMP protocol version.  v1, v2c, and v3 are supported.
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    95
  * **port**: The UDP port SNMP is listening on.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    96
  * **batchsize**: How many hosts to gather SNMP data on simultaneously.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    97
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    98
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
    99
### Category Options and Behavior
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   100
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   101
#### CPU
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   102
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   103
  * **warn_at**: Set the node to a `warning` state when utilization is at or over this percentage.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   104
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   105
Utilization takes into account CPU core counts, and uses the 5 minute
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   106
load average to calculate a percentage of current CPU use.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   107
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   108
2 properties are set on the node. `cpu` contains the detected CPU count
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   109
and current utilization. `load` contains the 1, 5, and 15 minute load
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   110
averages of the machine.
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   111
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   112
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   113
#### Disk
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   114
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   115
  * **warn_at**: Set the node to a `warning` state when disk capacity is at or over this amount.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   116
                 You can also set this to a Hash, keyed on mount name, if you want differing
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   117
                 warning values per mount point.  A mount point that is at 100% capacity will
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   118
                 be explicity set to `down`, as the resource it represents has been exhausted.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   119
  * **include**: String or Array of Strings.  If present, only matching mount points are
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   120
                 considered while performing checks.  These are treated as regular expressions.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   121
  * **exclude**: String or Array of Strings.  If present, matching mount point are removed
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   122
                 from evaluation.  These are treated as regular expressions.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   123
15
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   124
A single property "mounts" is set on the node, which is a hash keyed by
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   125
mountpoint, with current capacity values.
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   126
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   127
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   128
#### Memory
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   129
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   130
  * **physical_warn_at**: Set the node to a `warning` state when RAM utilization is at or over this percentage.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   131
  * **swap_warn_at**: Set the node to a `warning` state when swap utilization is at or over this percentage.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   132
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   133
Warnings are only set for swap by default, since that is usually a
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   134
better indication of an impending problem.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   135
15
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   136
2 properties are set on the node, "memory" and "swap".  Each is a Hash
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   137
that contains current usage and remaining available.
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   138
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   139
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   140
#### Processes
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   141
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   142
  * **check**: String or Array of Strings.  A list of processes to check if running.  These are
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   143
               treated as regular expressions, and include process arguments.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   144
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   145
If any process in the list is not found in the process table, the
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   146
resource is set to a `down` state.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   147
15
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   148
A single property is set on the node, a "counts" key that contains the
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   149
current number of running processes.
d4776d62b193 Include set property information for each monitor type.
Mahlon E. Smith <mahlon@martini.nu>
parents: 14
diff changeset
   150
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   151
20
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   152
#### UPS
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   153
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   154
##### Battery
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   155
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   156
  * **capacity_warn_at**: Set the node to a `warning` state when the battery capacity is at or below this percentage.
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   157
  * **temperature_warn_at**: Set the node to a `warning` state when the battery temperature is at or above this
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   158
                             temperature (in Celcius).
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   159
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   160
This check warns when the UPS is on battery, and reports the UPS' own
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   161
estimated time remaining.
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   162
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   163
A warning state will also be triggered based on battery status - low,
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   164
depleted, or unknown.
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   165
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   166
Examples
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   167
--------
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   168
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   169
In the simplest form, using default behaviors and settings, here's an
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   170
example Monitor configuration:
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   171
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   172
```
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   173
require 'arborist/snmp'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   174
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   175
Arborist::Monitor 'cpu load check', :cpu do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   176
	every 1.minute
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   177
	match type: 'resource', category: 'cpu'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   178
	exec( Arborist::Monitor::SNMP::CPU )
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   179
end
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   180
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   181
Arborist::Monitor 'partition capacity', :disk do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   182
	every 1.minute
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   183
	match type: 'resource', category: 'disk'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   184
	exec( Arborist::Monitor::SNMP::Disk )
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   185
end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   186
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   187
Arborist::Monitor 'process checks', :proc do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   188
	every 1.minute
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   189
	match type: 'resource', category: 'process'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   190
	exec( Arborist::Monitor::SNMP::Process )
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   191
end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   192
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   193
Arborist::Monitor 'memory', :memory do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   194
	every 1.minute
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   195
	match type: 'resource', category: 'memory'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   196
	exec( Arborist::Monitor::SNMP::Memory )
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   197
end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   198
```
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   199
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   200
Additionally, if you'd like these SNMP monitors to rely on the SNMP
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   201
service itself, you can add a UDP check for that.
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   202
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   203
```
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   204
Arborist::Monitor 'udp service checks', :udp do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   205
	every 30.seconds
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   206
	match type: 'service', protocol: 'udp'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   207
	exec( Arborist::Monitor::Socket::UDP )
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   208
end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   209
```
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   210
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   211
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   212
And a default node declaration:
4
e6eb11b1e00d Refactor. Move all SNMP "sections" to their own classes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 1
diff changeset
   213
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   214
```
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   215
Arborist::Host 'example' do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   216
	description 'An example host'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   217
	address 'demo.example.com'
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   218
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   219
	resource 'cpu'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   220
	resource 'memory'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   221
	resource 'disk'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   222
end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   223
```
4
e6eb11b1e00d Refactor. Move all SNMP "sections" to their own classes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 1
diff changeset
   224
e6eb11b1e00d Refactor. Move all SNMP "sections" to their own classes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 1
diff changeset
   225
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   226
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   227
All configuration can be overridden from the defaults using the `config`
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   228
pragma, per node.  Here's a more elaborate example that performs the following:
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   229
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   230
  * All SNMP monitored resources are quieted if the SNMP service itself is unavailable.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   231
  * Only monitor specific disk partitions, warning at different capacities .
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   232
  * Ensure the 'important' processing is running with the '--production' flag.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   233
  * Warns at 95% memory utilization OR 10% swap.
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   234
10
794cd469a1a2 README.md edited online with Bitbucket
Mahlon E. Smith <mahlon@martini.nu>
parents: 9
diff changeset
   235
-
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   236
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   237
```
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   238
Arborist::Host 'example' do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   239
	description 'An example host'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   240
	address 'demo.example.com'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   241
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   242
	service 'snmp', protocol: 'udp'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   243
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   244
	resource 'cpu', description: 'machine cpu load' do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   245
		depends_on 'example-snmp'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   246
	end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   247
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   248
	resource 'memory', description: 'machine ram and swap' do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   249
		depends_on 'example-snmp'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   250
		config physical_warn_at: 95, swap_warn_at: 10
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   251
	end
8
e0b7c95a154f Refactor for real world usage and latest Arborist behaviors.
Mahlon E. Smith <mahlon@martini.nu>
parents: 6
diff changeset
   252
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   253
	resource 'disk', description: 'partition capacity' do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   254
		depends_on 'example-snmp'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   255
		config \
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   256
			include: [
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   257
				'^/tmp',
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   258
				'^/var'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   259
			],
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   260
			warn_at: {
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   261
					'/tmp' => 50,
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   262
					'/var' => 80
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   263
			}
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   264
	end
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   265
11
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   266
	resource 'process' do
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   267
		depends_on 'example-snmp'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   268
		config check: 'important --production'
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   269
	end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   270
end
9187008b0989 More doc misc fixes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 10
diff changeset
   271
```
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   272
4
e6eb11b1e00d Refactor. Move all SNMP "sections" to their own classes.
Mahlon E. Smith <mahlon@martini.nu>
parents: 1
diff changeset
   273
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   274
## License
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   275
20
00a38d493f2c add UPS monitoring capability
Katelyn Schiesser <kschiesser@laika.com>
parents: 17
diff changeset
   276
Copyright (c) 2016-2019 Michael Granger and Mahlon E. Smith
0
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   277
All rights reserved.
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   278
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   279
Redistribution and use in source and binary forms, with or without
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   280
modification, are permitted provided that the following conditions are met:
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   281
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   282
* Redistributions of source code must retain the above copyright notice,
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   283
  this list of conditions and the following disclaimer.
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   284
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   285
* Redistributions in binary form must reproduce the above copyright notice,
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   286
  this list of conditions and the following disclaimer in the documentation
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   287
  and/or other materials provided with the distribution.
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   288
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   289
* Neither the name of the author/s, nor the names of the project's
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   290
  contributors may be used to endorse or promote products derived from this
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   291
  software without specific prior written permission.
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   292
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   293
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   294
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   295
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   296
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   297
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   298
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   299
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   300
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   301
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   302
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   303
8547a1ce445e Initial commit.
Mahlon E. Smith <mahlon@martini.nu>
parents:
diff changeset
   304