feat(team): add pagerduty_team_member_info metric to expose team members and their roles (#51)

Author: peterbueschel

README.md

@@ -90,6 +90,7 @@ This will run the container locally, mapping container port 8080 to local port 8
 | `pagerduty_stats`                                | Collector         | Collector stats                                                                                                      |
 | `pagerduty_api_counter`                          | Collector         | PagerDuty api call counter                                                                                           |
 | `pagerduty_team_info`                            | Team              | Team information                                                                                                     |
+| `pagerduty_team_member_info`                     | Team              | Team members and their team role                                                                                     |
 | `pagerduty_user_info`                            | User              | User information                                                                                                     |
 | `pagerduty_service_info`                         | Service           | Service (per team) information                                                                                       |
 | `pagerduty_maintenancewindow_info`               | MaintenanceWindow | Maintenance window information                                                                                       |
@@ -129,3 +130,9 @@ bottomk(1,
   ) - time() > 0
 )
 ```
+
+Team members
+```
+pagerduty_team_member_info{teamID="$TEAM_ID"}
+* on(userID) group_left(userName) pagerduty_user_info
+```

metrics_team.go

@@ -12,7 +12,8 @@ type MetricsCollectorTeam struct {
 	collector.Processor
 
 	prometheus struct {
-		team *prometheus.GaugeVec
+		team       *prometheus.GaugeVec
+		teamMember *prometheus.GaugeVec
 	}
 }
 
@@ -31,6 +32,17 @@ func (m *MetricsCollectorTeam) Setup(collector *collector.Collector) {
 		},
 	)
 	m.Collector.RegisterMetricList("pagerduty_team_info", m.prometheus.team, true)
+
+	m.prometheus.teamMember = prometheus.NewGaugeVec(
+		prometheus.GaugeOpts{
+			Name: "pagerduty_team_member_info",
+			Help: "PagerDuty team member information",
+		},
+		[]string{
+			"teamID", "userID", "role",
+		},
+	)
+	m.Collector.RegisterMetricList("pagerduty_team_member_info", m.prometheus.teamMember, true)
 }
 
 func (m *MetricsCollectorTeam) Reset() {
@@ -42,6 +54,7 @@ func (m *MetricsCollectorTeam) Collect(callback chan<- func()) {
 	listOpts.Offset = 0
 
 	teamMetricList := m.Collector.GetMetricList("pagerduty_team_info")
+	teamMembersMetricList := m.Collector.GetMetricList("pagerduty_team_member_info")
 
 	for {
 		m.Logger().Debug("fetch teams", slog.Uint64("offset", uint64(listOpts.Offset)), slog.Uint64("limit", uint64(listOpts.Limit)))
@@ -59,6 +72,20 @@ func (m *MetricsCollectorTeam) Collect(callback chan<- func()) {
 				"teamName": team.Name,
 				"teamUrl":  team.HTMLURL,
 			})
+
+			members, err := PagerDutyClient.ListTeamMembersPaginated(m.Context(), team.ID)
+			PrometheusPagerDutyApiCounter.WithLabelValues("ListTeamMemberships").Inc()
+			if err != nil {
+				m.Logger().Errorf("error fetching team members for team %s: %v", team.ID, err)
+				break
+			}
+			for _, member := range members {
+				teamMembersMetricList.AddInfo(prometheus.Labels{
+					"teamID": team.ID,
+					"userID": member.User.ID,
+					"role":   member.Role,
+				})
+			}
 		}
 
 		listOpts.Offset += list.Limit