package command import ( "fmt" "net" "regexp" "sort" "strings" consulapi "github.com/hashicorp/consul/api" "github.com/hashicorp/serf/serf" "github.com/ryanuber/columnize" ) // MembersCommand is a Command implementation that queries a running // Consul agent what members are part of the cluster currently. type MembersCommand struct { BaseCommand } func (c *MembersCommand) Help() string { helpText := ` Usage: consul members [options] Outputs the members of a running Consul agent. ` + c.BaseCommand.Help() return strings.TrimSpace(helpText) } func (c *MembersCommand) Run(args []string) int { var detailed bool var wan bool var statusFilter string var segment string f := c.BaseCommand.NewFlagSet(c) f.BoolVar(&detailed, "detailed", false, "Provides detailed information about nodes.") f.BoolVar(&wan, "wan", false, "If the agent is in server mode, this can be used to return the other "+ "peers in the WAN pool.") f.StringVar(&statusFilter, "status", ".*", "If provided, output is filtered to only nodes matching the regular "+ "expression for status.") f.StringVar(&segment, "segment", "", "(Enterprise-only) If provided, output is filtered to only nodes in"+ "the given segment.") if err := c.BaseCommand.Parse(args); err != nil { return 1 } // Compile the regexp statusRe, err := regexp.Compile(statusFilter) if err != nil { c.UI.Error(fmt.Sprintf("Failed to compile status regexp: %v", err)) return 1 } client, err := c.BaseCommand.HTTPClient() if err != nil { c.UI.Error(fmt.Sprintf("Error connecting to Consul agent: %s", err)) return 1 } // Check if we queried a server and need to query for members in all segments. var members []*consulapi.AgentMember if !wan && segment == "" { self, err := client.Agent().Self() if err != nil { c.UI.Error(fmt.Sprintf("Error retrieving agent info: %s", err)) return 1 } if self["Config"]["Server"].(bool) { segmentMembers, err := getSegmentMembers(client) if err != nil { c.UI.Error(fmt.Sprintf("Error retrieving members in segments: %s", err)) return 1 } members = segmentMembers } } else { var err error members, err = client.Agent().MembersOpts(consulapi.MembersOpts{ WAN: wan, Segment: segment, }) if err != nil { c.UI.Error(fmt.Sprintf("Error retrieving members: %s", err)) return 1 } } // Filter the results n := len(members) for i := 0; i < n; i++ { member := members[i] if member.Tags["segment"] == "" { member.Tags["segment"] = "" if member.Tags["role"] == "consul" { member.Tags["segment"] = "" } } statusString := serf.MemberStatus(member.Status).String() if !statusRe.MatchString(statusString) { members[i], members[n-1] = members[n-1], members[i] i-- n-- continue } } members = members[:n] // No matching members if len(members) == 0 { return 2 } sort.Sort(ByMemberNameAndSegment(members)) // Generate the output var result []string if detailed { result = c.detailedOutput(members) } else { result = c.standardOutput(members) } // Generate the columnized version output := columnize.SimpleFormat(result) c.UI.Output(output) return 0 } // so we can sort members by name type ByMemberNameAndSegment []*consulapi.AgentMember func (m ByMemberNameAndSegment) Len() int { return len(m) } func (m ByMemberNameAndSegment) Swap(i, j int) { m[i], m[j] = m[j], m[i] } func (m ByMemberNameAndSegment) Less(i, j int) bool { switch { case m[i].Tags["segment"] < m[j].Tags["segment"]: return true case m[i].Tags["segment"] > m[j].Tags["segment"]: return false default: return m[i].Name < m[j].Name } } // standardOutput is used to dump the most useful information about nodes // in a more human-friendly format func (c *MembersCommand) standardOutput(members []*consulapi.AgentMember) []string { result := make([]string, 0, len(members)) header := "Node|Address|Status|Type|Build|Protocol|DC|Segment" result = append(result, header) for _, member := range members { addr := net.TCPAddr{IP: net.ParseIP(member.Addr), Port: int(member.Port)} protocol := member.Tags["vsn"] build := member.Tags["build"] if build == "" { build = "< 0.3" } else if idx := strings.Index(build, ":"); idx != -1 { build = build[:idx] } dc := member.Tags["dc"] segment := member.Tags["segment"] statusString := serf.MemberStatus(member.Status).String() switch member.Tags["role"] { case "node": line := fmt.Sprintf("%s|%s|%s|client|%s|%s|%s|%s", member.Name, addr.String(), statusString, build, protocol, dc, segment) result = append(result, line) case "consul": line := fmt.Sprintf("%s|%s|%s|server|%s|%s|%s|%s", member.Name, addr.String(), statusString, build, protocol, dc, segment) result = append(result, line) default: line := fmt.Sprintf("%s|%s|%s|unknown||||", member.Name, addr.String(), statusString) result = append(result, line) } } return result } // detailedOutput is used to dump all known information about nodes in // their raw format func (c *MembersCommand) detailedOutput(members []*consulapi.AgentMember) []string { result := make([]string, 0, len(members)) header := "Node|Address|Status|Tags" result = append(result, header) for _, member := range members { // Get the tags sorted by key tagKeys := make([]string, 0, len(member.Tags)) for key := range member.Tags { tagKeys = append(tagKeys, key) } sort.Strings(tagKeys) // Format the tags as tag1=v1,tag2=v2,... var tagPairs []string for _, key := range tagKeys { tagPairs = append(tagPairs, fmt.Sprintf("%s=%s", key, member.Tags[key])) } tags := strings.Join(tagPairs, ",") addr := net.TCPAddr{IP: net.ParseIP(member.Addr), Port: int(member.Port)} line := fmt.Sprintf("%s|%s|%s|%s", member.Name, addr.String(), serf.MemberStatus(member.Status).String(), tags) result = append(result, line) } return result } func (c *MembersCommand) Synopsis() string { return "Lists the members of a Consul cluster" }