Cookbook

1. Nested SSH Access

Let's say that you are trying to access a node that is inside a private network for which you need to SSH into a gateway first. You can achieve this by nesting two SSH accessors:

node:
  - name: protected-node
    host: protected1.mydomain.com
    access:
       - class: robob.access.ssh
         username: username-for-protected-node
         password/key: secret
       - class: robob.access.ssh
         host: gateway.mydomain.com
         username: username-for-gateway
         password/key: secret

2. Re-using a streamlet to another stream

Streamlets expose some metrics in the global scope. If you want to specialize them in a specific stream you can use the alias keyword to rename the metrics:

metrics:
  - name: node1.load
    title: CPU Load of node 1
  - name: node2.load
    title: CPU Load of node 2

stream:
  - app: myapp
    node: node1
    streamlets:
      - streamlet: uptime
        alias:
          load: node1.load      

  - app: myapp
    node: node2
    streamlets:
      - streamlet: uptime
        alias:
          load: node2.load