Filtering and Tagging

Tags

You can use the NSOLID_TAGS environment variable to add tags that will be applied to a process. This can aid in identification and filtering, particularly when creating Saved Views in N|Solid Console. Tags can also be retrieved using the info command in the N|Solid CLI.

Setting Tags

$ NSOLID_APPNAME="leaderboard" NSOLID_TAGS="DC, us-east-1" nsolid app

Retrieving Tags

$ nsolid-cli info --q app=leaderboard

Example JSON Response

{
  "id": "57234c38b3f08dd8a3e9a567c82887a552c27b01",
  "app": "leaderboard",
  "tags": [ "DC", "us-east-1" ],
  "pid": 2440,
  ...
}

Tag Constraints

• Tags can contain any whitespace characters
• Tags are trimmed, so only whitespace in the middle of a tag is kept intact
• Tags cannot contain commas and commas cannot be escaped
• Tags are transmitted exactly the way they are entered and therefore are case sensitive, i.e. world is different than wOrld
• The byte length of a tag must be between 2 and 140
• There is no minimum number of tags per process
• There is a maximum of 20 tags per process allowed
• Tags cannot be changed at runtime

Filtering

As many applications are comprised of tens to thousands of processes, it is often necessary to be able to filter a subset based on some criteria. The N|Solid Console offers a filtering mechanism with auto-complete to help you navigate your complex applications.

Filters

Typing just the filter name will list all of the items for that filter. Subsequent characters are then used to find partial matches within that filter.

Here are the currently supported filters in the N|Solid Console:

Filter Name	Description
host	Hostname(s) for the selected application's processes
name	Application name as specified by NSOLID_APPNAME
pid	Process IDs (pids)
tag	Custom process tags (if any) as specified by NSOLID_TAGS
title	Process title(s)

You may enter multiple filters and search terms in the filter box. Multiple terms will be logically AND'ed together when they are applied to the set of processes being filtered.