Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: minor edits

...

Service Tagging requires a Server Visibility license. Server Tagging is currently available for Linux, Windows, and Solaris. 

TBD DOCS-2010

 

 

 

 

 

Server Visibility can import the following tags automatically.

Server the following tags from the Machine Agent. These tags require of the Controller and of the Standalone Machine Agent.These tags require of the Controller and the These tags require 3 of the Controller and the These tags require of the Controller and the
SourceTagsNotes
Controller / Agent Requirements
Custom

Server Visibility can import

  • Controller 4.4 or higher
  • Standalone Machine Agent 4.4 or higher
Machine Agent

These tags appear in the Server Dashboard under Tags.

  • OS Architecture
  • OS Kernel
  • AppDynamics Agent Version
  • Controller 4.4 or higher
  • Standalone Machine Agent 4.2 or higher
Amazon Web Services

These tags appear in the Server Dashboard under Tags as AWS|<tag>. See Importing Tags from Amazon Web Services below.

  • resource-id
  • availability-zone
  • region
  • ami-id
  • instance-type
  • security-group
  • Controller 4.4 or higher
  • Standalone Machine Agent 4.4 or higher
Docker

Server Visibility can import user-defined tags and system container-level tags. These appear under Container Details > Tags as Docker|<tag>.

The exact set of tags imported can vary depending on the system on which the container is running.

  • Controller 4.
  • 4.3 or higher
  • Standalone Machine Agent 4.4.3 or higher

Kubernetes

OpenShift

Server Visibility can import ReplicaSet and pod tags. These appear under Container Details > Tags as K8s|<tag>.
  • Controller 4.4.3 or higher
  • Standalone Machine Agent 4.4.3 or higher

 

Viewing Servers by Tag in the Controller UI

...

  1. Tier tag that equals ECommWeb OR ECommInventory, AND
  2. An OS Architecture tag that equals x86_64.

Image Removed

Image Added

Anchor
custom
custom
Defining and Viewing Tags for a Server

You can specify custom tags as a set of key/value strings in the agent config directory. Each agent can support up to 50 tags by default.

Info

Note the following good practices for defining server tags:

  • If an agent is deployed in Amazon Web Services, the agent can auto-detect and import tags defined in AWS. The Controller also auto-assigns a set of default tags to each server.
    The primary use case for custom tags is to specify information that is not already specified in AWS and auto-assigned tags. Before you specify custom tags in the agent config directory, it is good practice to review the current set of tags: go to the Server Dashboard and view the Tags pane at the bottom of the page.
    Image RemovedImage Added

    Be careful not to define duplicate tags in the YML file.

 

Div
styleclear:both;

Configure the following option in <machine_agent_home>/extensions/ServerMonitoring/ServerMonitoringConfig.yml :

SettingDescription

tag

A list of user-defined tags for the individual server. You can use these tags to query, filter, aggregate, and compare related servers.
Each tag is specified by a key-value pair. You can define tag names up to 127 unicode Unicode characters and tag values up to 255 unicode Unicode characters. Define each each key on a separate line. All key/value strings should be within single quotes. If a key has multiple values, delineate the list with commas:
<key>: [ <value> ]  
tags:
    'Location': ['NYC', 'Data Center', 'Server Room 7']
    'Environment': ['preProduction']

 

Importing Tags from Docker

Server Visibility can import some tags from Docker. See Kubernetes and AppDynamics APM.

TBD – DOCS-2010

Importing Tags from Kubernetes

...

Anchor
imp-tags-aws
imp-tags-aws
Importing Tags from Amazon Web Services

Info

Detailed information about Amazon Web Services is outside the scope of AppDynamics documentation. The following links are provided as a convenience and might not work if Amazon reorganizes its website or documentation.

...

Before Server Visibility can import tags from AWS, you must must set up IAM roles:
  1. Log in to the AWS console: https://console.aws.amazon.com/iam/
  2. Create a role that has read access to EC2 tags.
    Specifically, the role must have an AWS Managed Policy with the required permissions (such as AmazonEC2ReadOnlyAccess) attached. 
  3. Add this role to your EC2 instance.
    For information about these two steps, search for "To create an IAM role using the IAM console" and "Attaching an IAM Role to an Instance" in the following page:
     http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html
  4. Run the Standalone Machine Agent with Amazon Web Services enabled.

...

Div
styleclear:both;
Server Visibility PropertyDescriptionDefault
sim.machines.tags.enabled

Enable/disable server tags for all servers.

True
 simsim.machines.tags.aws.enabledEnable/disable the collection of AWS tags for all servers.True
 simsim.machines.tags.aws.pollingInterval

Length of time in milliseconds between each polling of AWS tags

21600000
(6 hours)  

 simsim.machines.tags.maxPerMachineMaximum number of unique tags per account. 50
 simsim.machines.tags.maxPerAccount

Maximum number of unique tags per account.

 500

 

Configuration Options for Docker Tags

The machine agent can be configured to collect different types of tags. By default, all tags are collected. To turn off tag collection, set dockerTagsEnabled to "false".

  1. Edit the <machine_agent_home>/extensions/DockerMonitoring/DockerMonitoringConfig.yml file.
  2. Under the containerMonitoringConfig section, set dockerTagsEnabled: "false"

    Code Block
    # WARNING: Before making any changes to this file read the following section carefully
    # 
    # After editing the file, make sure the file follows the yml syntax. Common issues include
    # - Using tabs instead of spaces
    # - File encoding should be UTF-8
    #
    # The safest way to edit this file is to copy paste the examples provided and make the
    # necessary changes using a plain text editor instead of a WYSIWYG editor.
    #
    
    # samplingInterval indicates how often to gather metric data. Units in milliseconds.
    samplingInterval: 30000
    
    containerMonitoringConfig:
        # containerProcessSelectorRegex defines regular expression to evaluate the processes in
        # each running container to be monitored by the machine agent. The regular expression is
        # compared against each process full command line within running
        # If the pattern matches, then the machine agent start monitoring it.
        containerProcessSelectorRegex: ".*[ ]-Dappdynamics.*"
        dockerTagsEnabled: "false" 

Configuration Options for AWS Tags

The machine agent can be configured to collect different types of tags. By default, all tags are collected. To turn off tag collection, set awsTagsEnabled to "false".

  1. Edit the <machine_agent_home>/extensions/ServerMonitoring/conf/ServerMonitoring.yml file.
  2. Set awsTagsEnabled: "false" 

 

Code Block
//ServerMonitoring.yml
# WARNING: Before making any changes to this file read the following section carefully
# 
# After editing the file, make sure the file follows the yml syntax. Common issues include
# - Using tabs instead of spaces
# - File encoding should be UTF-8
#
# The safest way to edit this file is to copy paste the examples provided and make the
# necessary changes using a plain text editor instead of a WYSIWYG editor.
#
awsTagsEnabled: "false"
# samplingInterval indicates how often to gather metric data. Units in milliseconds.
samplingInterval: 30000
...

 

Configuration Options for Kubernetes and OpenShift Tags

The machine agent can be configured to collect different types of tags. By default, all tags are collected. To turn off tag collection, set k8sTagsEnabled to "false".

  1. Edit the <machine_agent_home>/extensions/ServerMonitoring/conf/ServerMonitoring.yml file.
  2. Set k8sTagsEnabled: "false"
Code Block
//ServerMonitoring.yml
# WARNING: Before making any changes to this file read the following section carefully
# 
# After editing the file, make sure the file follows the yml syntax. Common issues include
# - Using tabs instead of spaces
# - File encoding should be UTF-8
#
# The safest way to edit this file is to copy paste the examples provided and make the
# necessary changes using a plain text editor instead of a WYSIWYG editor.
#
k8sTagsEnabled: "false"
# samplingInterval indicates how often to gather metric data. Units in milliseconds.
samplingInterval: 30000
...