gdash

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #golang #android #rust #nodejs #java #cli #kubernetes #vue #pytorch #ios #open-source

(★ 16)

Cookbook to automatically deploy the Gdash web interface for Graphite.

gdash 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Description
===========

Cookbook to automatically deploy the Gdash web interface for
Graphite. Resources are provided for automated graph and dashboard
creation.

Requirements
============

## Platform:

* Debian
 * Ubuntu

## Cookbooks

* build-essentials
 * runit
 * graphite
 * unicorn
 * optional dependency: iptables

Attributes
==========

* `node['gdash']['tarfile']` - Full path to store downloaded tgz
 * `node['gdash']['base']` - Full path for gdash root
 * `node['gdash']['url']` - Download url for gdash tarball
 * `node['gdash']['templatedir']` - Dashboard template directory
 * `node['gdash']['dashboards']` - Attributes defining the set of dashboards.
 * `node['gdash']['owner']` - User gdash runs as
 * `node['gdash']['group']` - Group permission for gdash
 * `node['gdash']['basic_auth']` - Toggle basic auth setting for
   dashboard access
 * `node['gdash']['username']` - Basic auth username
 * `node['gdash']['password']` - Basic auth password
 * `node['gdash']['title']` - Dashboard main title
 * `node['gdash']['refresh_rate']` - Refresh rate
 * `node['gdash']['columns']` - Number of columns
 * `node['gdash']['graphite_whisperdb']` - Full path to graphite database

=======
   whisper database
 * `node['gdash']['port']` - Port gdash is available on
 * `node['gdash']['categories']` - Categories to group dashboards into

Resources
=========

* gdash_dashboard - Create a dashboard with a category and description
  * gdash_dashboard_component - Create a graph and add it to a dashboard

Recipes
=======

default
-------

The default recipe performs basic setup of gdash and creates a runit
service definition.

firewall
--------

The firewall recipe uses iptables to open ports for the dashboard.
This is optional and requires the iptables cookbook if used.

basic_dashboard
---------------

The basic_dashboard recipe is intended an example to get up and
running with gdash and automatic graph creation. Use this recipe and
the usage description to get started building your own dashboards with
the resources provided by this cookbook.

Usage
=====

Graph creation is left to the user but an recipe is provided to
create a basic dashboard and provide usage examples.

Graph Creation
==============

Dashboard creation
------------------

First create a dashboard:

```ruby

properties = { :timezone => "Europe/London" }

gdash_dashboard 'cpu_usage' do
  category 'metrics'
  description 'CPU Usages'
  graph_properties properties
end
```

Dashboard component creation
----------------------------

Next, add components to the dashboard. Dashboards are referenced by
their name and category when adding components:

```ruby

gdash_dashboard_component 'node1' do
  dashboard_name 'cpu_usage'
  dashboard_category 'metrics'
  linemode 'slope'
  description 'Node1 CPU usage'
  fields(
    :system => {
      :scale => 0.001,
      :color => 'orange',
      :alias => 'System Usage 0',
      :data => 'node1.cpu.0.system.value'
    },
    :user => {
      :scale => 0.001,
      :color => 'blue',
      :alias => 'User Usage 0',
      :data => 'node1.cpu.0.user.value'
    }
  )
end
```

Dashboard creation via attributes
---------------------------------

Alternatively attributes can be used to define the set of dashboards
and the `attribute_driven_dashboard` recipe can be used to managed the
dashboards. The recipe will remove categories, dashboards and dashboard
components that no longer exist and create all those as specified in
attributes. For example:

```ruby

node.override['gdash']['dashboards']['cpu_usage'] =
  {
    'category' => 'metrics',
    'description' => 'CPU Usages of the nodes across the cluster',
    'display_name' => 'CPU Usages',
    'graph_properties' => {
      'timezone' => 'Europe/London'
    },
    'components' => {
      'node1' => {
        'linemode' => 'slope',
        'description' => 'Node1 CPU usage',
        'fields' => {
            :system => {
              :scale => 0.001,
              :color => 'orange',
              :alias => 'System Usage 0',
              :data => 'node1.cpu.0.system.value'
            },
            :user => {
              :scale => 0.001,
              :color => 'blue',
              :alias => 'User Usage 0',
              :data => 'node1.cpu.0.user.value'
            }
        }
      }
    }
  }
end
```

gdash

gdash 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

gdash

gdash 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README