Pod labels in AAKE v26

[Michael A. Lowry]

Automic Automation Kubernetes Edition version 26 introduces automatic labeling of pods. Since this feature is not (yet) documented, I thought I would provide a description based on what I have learned after using v26 for a couple of days.

Label	Description	Example(s)	Notes
process-name	AE process name	AE_DEV-CP001, AE_DEV-WP023	System name is always included.
process-type	AE process type	PWP, WP, CP, JCP, JWP, REST
process-roles/O	WP has Outputs role	true (Unset = false)	See WP Server Roles.
process-roles/R	WP has Resource Calculations role
process-roles/M	WP has Max Parallel Executions role
process-roles/S	WP has Sync Objects role
process-roles/AUT	JWP has Authentication role		See JWP Server Roles.
process-roles/IDX	JWP has Indexing role
process-roles/PER	JWP has Periodic Tasks role
process-roles/UTL	JWP has Utility role
process-roles/JWP	JWP started without dedicated role
host-name	DNS name of pod	wp-0-7b775789cc-m6txh	Always identical to pod name.
connection-count	Number of TCP connections	4
net-area	Network area	AE_DEV	Usually just the system name.
pod-template-hash	Pod template hash	7b775789cc

To see these labels from the command line, you can use the --label-columns option of kubectl.

 kubectl get pods --label-columns=process-roles/M,process-roles/O,process-roles/R,process-roles/S,process-roles/AUT,process-roles/IDX,process-roles/PER,process-roles/UTL

If you use K9s, you can configure your views.yaml file to display the labels in additional columns.

views:
  v1/pods:                                          # Views for v26 and later
    sortColumn: PROC:asc
    columns:
      - PROC:.metadata.labels.process-name
      - TYPE:.metadata.labels.process-type
      - AUT:.metadata.labels.process-roles/AUT |LW  # Left-align these columns (L)
      - IDX:.metadata.labels.process-roles/IDX |LW  # Display only in wide mode (W)
      - PER:.metadata.labels.process-roles/PER |LW  # (Type Control-W to toggle wide mode.)
      - UTL:.metadata.labels.process-roles/UTL |LW
      - M:.metadata.labels.process-roles/M |LW
      - O:.metadata.labels.process-roles/O |LW
      - R:.metadata.labels.process-roles/R |LW
      - S:.metadata.labels.process-roles/S |LW
      - CONN:.metadata.labels.connection-count |RW  # Right-align numeric columns
      - NET_AREA:.metadata.labels.netarea |W
      - HOSTNAME:.metadata.labels.host-name |W
      - TEMPLATE_HASH:.metadata.labels.pod-template-hash |W

If you're still using a version prior to v26, you can use my 'ae' Bash function to label your pods.

Enjoy!

-------------------------------------------

[Michael A. Lowry]

Here is an example of how a v26 cluster looks in K9s with the above views.yaml file. (Type Control-W to toggle wide mode and enable the extra columns.)