Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

swisnap (2) Versions 1.0.0

Install SolarWinds Snap Agent for Linux and Windows

Policyfile
Berkshelf
Knife
cookbook 'swisnap', '~> 1.0.0', :supermarket
cookbook 'swisnap', '~> 1.0.0'
knife supermarket install swisnap
knife supermarket download swisnap
README
Dependencies
Quality 17%

SolarWinds Snap Agent Chef recipes

CircleCI

Chef recipes and resources for SolarWinds Snap Agent Linux and Windows installation.

Table of contents

Usage

  • Download swisnap recipes to your Chef server.

Using Berkshelf:

# add to Berksfile
cookbook 'swisnap'

Or using Knife tool:

knife cookbook site install swisnap
  • Download recipe dependencies (SolarWinds Snap Agent has dependency to PackageCloud Chef recipes).

  • Change attribute ['swisnap']['solarwinds_token'] from SOLARWINDS_TOKEN, to your AppOptics API token in [attributes/default.rb](attributes/default.rb).

  • Send to Chef Server up-to-date version of recipes and its dependencies.

berks upload swisnap
knife cookbook upload swisnap --include-dependencies
  • Add swisnap::default recipe to run list of desired nodes, which shall be monitored:
recipe[swisnap::default]
  • Run chef-infra, on Chef nodes by manual trigger, or by using another recipe for scheduled triggers if enabled.

Attributes

[default.rb file](attributes/default.rb) represents various attributes releated to SolarWinds Snap Agent instalation and runtime. Depending on the needs they can be altered to modify Agent configuration.

['swisnap']['swisnap_log_level']
['swisnap']['swisnap_log_format']

Logging level and log format. Default value is warning and text.

['swisnap']['swisnap_plugin_trust_level']
['swisnap']['swisnap_keyring_paths']

Plugin trust level for swisnapd. When enabled, only signed plugins that can be verified will be loaded into swisnapd. Signatures are verified from keyring files specified in swisnap_keyring_path. Valid values are 0 - Off, 1 - Enabled, 2 - Warning. Default value is 1 - Enabled. If this is not set, then agent will use default enabled level.

['swisnap']['swisnap_tls_cert_path']
['swisnap']['swisnap_tls_key_path']
['swisnap']['swisnap_plugin_tls_cert_path']
['swisnap']['swisnap_plugin_tls_key_path']
['swisnap']['swisnap_ca_cert_paths']

Secure plugin communication optional parameters.

['swisnap']['swisnap_plugin_load_timeout']

The maximal time allowed for a plugin to load. Default value is 30.

['swisnap']['swisnap_global_tags']

Tags that will be applied to collected metrics across all tasks. They should be set as Hash (key => value) format.

['swisnap']['swisnap_restapi_enable']
['swisnap']['swisnap_restapi_rest_auth']
['swisnap']['swisnap_restapi_rest_auth_password']
['swisnap']['swisnap_restapi_rest_certificate']
['swisnap']['swisnap_restapi_rest_key']
['swisnap']['swisnap_restapi_addr']
['swisnap']['swisnap_restapi_plugin_load_timeout']

Optional REST API parameters. By default REST API is enabled.

Note: below attributes are OS specific (different for Linux and Windows).

['swisnap']['swisnap_auto_discover_path']

Path to SolarWinds Snap Agent's autoload directory for V1 plugins.

['swisnap']['swisnap_log_path']

Path to log file for Snap.

['swisnap']['swisnap_plugin_config_dir']

Path to SolarWinds Snap Agent's plugin configuration files.

['swisnap']['swisnap_plugin_path']

Path where SolarWinds Snap Agent's plugins binaries are stored.

['swisnap']['swisnap_tasks_autoload_path']

Path to SolarWinds Snap Agent's V2 tasks files.

['swisnap']['swisnap_task_path']

Path to SolarWinds Snap Agent's V1 tasks files.

Below attributes are releated to Publishers plugins configuration

['swisnap']['swisnap_hostname_alias']

Hostname alias for the server which will be used in AppOptics UI.

['swisnap']['swisnap_proxy_url']
['swisnap']['swisnap_proxy_user']
['swisnap']['swisnap_proxy_password']

Optional proxy settings.

default['swisnap']['swisnap_host_check_timeout']

swisnap_host_check_timeout allows to configure timeout for querying host operating system for identification informations. Default value is set to 5s.

['swisnap']['swisnap_floor_seconds']

Whether to floor timestamps to a specific interval, default value is 60 seconds.

['swisnap']['swisnap_period']

Metrics interval period to report to AppOptics API, default value is 60 seconds.

['swisnap']['swisnap_ec2_check_timeout']

swisnap_ec2_check_timeout allows to configure timeout for querying EC2 instance metadata URL to determine if host agent is running on EC2 (or OpenStack) instance. By default it is set to 1s.

['swisnap']['swisnap_ec2_check_retries']

swisnap_ec2_check_retries allows to configure number of retries for querying EC2 instance metadata URL to determine if host agent is running on EC2 (or OpenStack) instance. By default it is set to 3.

Dependent cookbooks

packagecloud >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

1.0.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

1.0.0 failed this metric

FC064: Ensure issues_url is set in metadata: swisnap/metadata.rb:1
FC065: Ensure source_url is set in metadata: swisnap/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: swisnap/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

1.0.0 passed this metric

Testing File Metric
            

1.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

1.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number