Bindplane

The Bindplane Developer Hub

Welcome to the Bindplane developer hub. You'll find comprehensive guides and documentation to help you start working with Bindplane as quickly as possible, as well as support if you get stuck. Let's jump right in!

Amazon EKS

Elastic Container Service for Kubernetes

Data Collection Setup

Metrics are collected via the Amazon EKS API endpoint and Kubernetes cluster API. See the Network Requirements for more details.

Network Requirements

The BindPlane Collector MUST have access to the following:

  • The EKS API Server: Port: 443 (TCP) HTTPS to the Amazon Cloudwatch API
  • Kubelet Port: 10250 (TCP)

🚧

For users intending to deploy a BindPlane Collector that is not within the same VPC that the EKS Cluster exists in, please be aware of the following

The security group used to control access to the individual networks will need to open up port 10250 to the collector. This change will usually be performed in the Cloudformation template used to build out the worker nodes, or any other systems being used to manage the EKS worker nodes.

In the Kubernetes Source configuration, the External IPs selection may need to be made if the collector resides on a network segment that does not have access to the private worker node IPs.

Least Privileged User

Amazon User

Navigate to the AWS console and create an IAM user with programmatic access. The user will need the following permissions. You can create a policy specifically for these permissions and apply the permissions to the user.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "ec2:Describe*",
                "ec2:Get*",
                "ec2:Search*",
                "eks:Get*",
                "eks:Describe*"
            ],
            "Resource": "*"
        }
    ]
}

EKS Cluster: Setting Up A Monitoring User

To setup a monitoring user on the EKS cluster

  1. Ensure that you have the aws-iam-authenticator installed. Click here for more details

📘

Where do I install the aws-iam-authenticator?

The installation of the aws-iam-authenticator must be done on your main management workstation.

  1. Install the bindplane-monitoring role. To do this, run the following commands against your Kubernetes Cluster:
kubectl apply -f https://raw.githubusercontent.com/BlueMedoraPublic/bm-kube-lpu/master/bluemedora-lpu/bm-clusterrole.yaml

kubectl apply -f https://raw.githubusercontent.com/BlueMedoraPublic/bm-kube-lpu/master/bluemedora-lpu/bm-clusterrolebinding.yaml

kubectl apply -f https://raw.githubusercontent.com/BlueMedoraPublic/bm-kube-lpu/master/bluemedora-lpu/bm-role.yaml

kubectl apply -f https://raw.githubusercontent.com/BlueMedoraPublic/bm-kube-lpu/master/bluemedora-lpu/bm-rolebinding.yaml

kubectl apply -f https://raw.githubusercontent.com/BlueMedoraPublic/bm-kube-lpu/master/bluemedora-lpu/bm-serviceaccount.yaml
  1. Obtain the token to use with the monitoring user. (The example below is for a Linux system)
kubectl -n kube-system describe secret $(kubectl -n kube-system get secret | grep bluemedora | awk '{print $1}')

BindPlane Collector & Kubernetes Source Setup

Gather information from your EKS cluster

From the main EKS configuration page, the following information will be needed:

  • The API Server endpoint
  • VPC
  • Subnet(s)
  • Security Group

EKS Configuration Page

Deploy a collector

Select the AWS Cloudformation platform when deploying a collector in BindPlane:

  • Use the same VPC, Subnet, and Security Group collected in the previous step
  • "Assign a public IP" can be left off unless you need it for administrative purposes
  • Select a Key Pair to allow for the management of the system
  • Click Deploy

Configure the Kubernetes Source

  • Host: This is the API Server endpoint previously collected, but without the https:// included
  • Port: 443
  • Kubelet Port: 10250
  • Credentials: Use the monitoring token from above
  • Use External or Internal IPs: Use Internal IPs
  • SSL Configuration: No Verify

Connection Parameters

NameRequired?Description
Region
Access Key IDRequired
Secret Access KeyRequired
Additional ThreadsThe number of additional threads allowed to be utilized during collection.
Request Timeout (seconds)The number of seconds to allow for the API to return a response.
HostRequiredThe Kubernetes host to connect to.
Kubelet PortThe port for communication to the Kubernetes kubelet.
Bearer TokenRequired
Use External or Internal IPsDetermines if Node external or internal IP addresses are used for connection.
SSL ConfigurationThe SSL mode to use when connecting to the target. Can be configured to not use SSL (No SSL), use SSL but do not verify the target's certificate (No Verify), and use SSL and verify the target's certificate (Verify).
Cluster NameRequiredThe name of the cluster as defined in EKS.
Event Cutoff TimeOnly events with a 'last updated' timestamp that is after this timestamp will be collected.
Connection TimeoutThe number of seconds to allow for connecting to the target.
Max Simultaneous Kubelet RequestsSets the maximum simultaneous requests to Kubelets. Set to 0 to disable throttling.
Collect ContainersToggles the collection of containers.
Collect VolumesToggles the collection of volumes.
Collect from Kubelet APIToggles the collection from the cAdvisor API used by the Kubelets.

Metrics

Cluster

NameDescription
ARNThe Amazon Resource Name (ARN) of the cluster.
Average CPU Usage (Nanocores)The current average CPU usage per node in this Kubernetes Cluster.
Average Filesystem Space (Bytes)The average filesystem space per node in this Kubernetes Cluster.
Average Filesystem Used (Bytes)The average used filesystem space per node in this Kubernetes Cluster.
Average Memory Usage (Bytes)The current average memory usage per node in this Kubernetes Cluster.
Certificate AuthorityThe base64 encoded certificate data required to communicate with your cluster.
Client Request TokenUnique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Created At (Seconds)The Unix epoch timestamp in seconds for when the cluster was created.
EndpointThe endpoint for your Kubernetes API server.
Failed Pod CountThe current number of pods in this Kubernetes Cluster in a Failed phase.
NameThe name of the cluster.
Node CountThe current number of nodes in this Kubernetes Cluster.
Not Ready Node CountThe current number of nodes in this Kubernetes Cluster in a Not Ready condition.
Not Ready Pod CountThe current number of pods in this Kubernetes Cluster in a Not Ready condition.
Pending Pod CountThe current number of pods in this Kubernetes Cluster in a Pending phase.
Platform VersionThe platform version of your Amazon EKS cluster.
Pod CapacityThe total pod capacity of this Kubernetes Cluster.
Pod CountThe current number of pods in this Kubernetes Cluster.
Ready Node CountThe current number of nodes in this Kubernetes Cluster in a Ready condition.
Ready Pod CountThe current number of pods in this Kubernetes Cluster in a Ready condition.
RegionThe AWS Region this object belongs to.
Role ARNThe Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf.
Running Not Ready Pod CountThe current number of pods in this Kubernetes Cluster in a Running phase, but not a Ready condition.
Running Pod CountThe current number of pods in this Kubernetes Cluster in a Running phase.
StatusThe current status of the cluster.
Succeeded Pod CountThe current number of pods in this Kubernetes Cluster in a Succeeded phase.
Total CPU Capacity (Nanocores)The total CPU capacity over all nodes in this Kubernetes Cluster.
Total CPU Usage (Nanocores)The current CPU usage over all nodes in this Kubernetes Cluster.
Total CPU Usage Ratio (%)The current CPU usage over all nodes in this Kubernetes Cluster.
Total Filesystem Space (Bytes)The total filesystem space over all nodes in this Kubernetes Cluster.
Total Filesystem Usage (%)The current filesystem usage over all nodes in this Kubernetes Cluster.
Total Filesystem Used (Bytes)The total used filesystem space over all nodes in this Kubernetes Cluster.
Total Memory (Bytes)The total memory capacity over all nodes in this Kubernetes Cluster.
Total Memory Usage (Bytes)The current memory usage over all nodes in this Kubernetes Cluster.
Total Memory Usage Ratio (%)The current memory usage over all nodes in this Kubernetes Cluster.
Total Received Data (Bytes)The total received data over all nodes in this Kubernetes Cluster.
Total Transmitted Data (Bytes)The total transmitted data over all nodes in this Kubernetes Cluster.
Unknown Node CountThe current number of nodes in this Kubernetes Cluster in an Unknown condition.
Unknown Pod CountThe current number of pods in this Kubernetes Cluster in an Unknown condition.
VersionThe Kubernetes server version for the cluster.
VPC IDThe VPC associated with your cluster.
VPC Security Group IDsThe security groups associated with the cross-account elastic network interfaces that are used to allow communication between your worker nodes and the Kubernetes control plane.
VPC Subnet IDsThe subnets associated with your cluster.

Container

NameDescription
Available Space (Bytes)The storage space available for the filesystem.
CPU Limit (Nanocores)The maximum CPU usage this container is allowed to consume.
CPU Limit Usage (%)The total CPU Usage in proportion to the CPU Limit.
CPU Request (Nanocores)The minimum CPU usage this container requires for it to be scheduled.
CPU Request Usage (%)The total CPU Usage in proportion to the CPU Request.
CPU Time (Nanoseconds)Cumulative CPU time (sum of all cores) since object creation.
CPU Usage (Nanocores)Total CPU usage (sum of all cores) averaged over the sample window.
Free inodesThe number of free inodes in the filesystem.
ImageThe Image name of this container.
Major Page FaultsCumulative number of major page faults.
Memory Limit (Bytes)The maximum Memory usage this container is allowed to consume.
Memory Limit Usage (%)The total Memory Usage in proportion to the Memory Limit.
Memory Request (Bytes)The minimum memory this container requires for it to be scheduled.
Memory Request Usage (%)The total Memory Usage in proportion to the Memory Request.
Memory Usage (Bytes)Total memory in use. This includes all memory regardless of when it was accessed.
Minor Page FaultsCumulative number of minor page faults.
NameName of the Container.
Pod NameName of the Pod the Container is running on.
Pod NamespaceNamespace of the Pod the Container is running on.
ReadyThe Container is Ready when it is ready to start accepting traffic.
RegionThe AWS Region this object belongs to.
Restart CountThe number of times this container has restarted.
RSS Usage (Bytes)The amount of anonymous and swap cache memory (includes transparent hugepages).
Start TimeThe time that this container started running.
Total inodesThe total number of inodes in the filesystem.
Total Space (Bytes)The total capacity of the filesystems underlying storage.
Used inodesThe number of inodes used by the filesystem.
Used Space (Bytes)The storage space used on the filesystem.
Used Space Ratio (%)The storage space used on the filesystem.
Working Set Usage (Bytes)The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory.

Deployment

NameDescription
Available ReplicasTotal number of available pods (ready for at least minReadySeconds) targeted by this deployment.
Collision CountCount of hash collisions for the Deployment. The Deployment controller uses this field as a collision avoidance mechanism when it needs to create the name for the newest ReplicaSet.
Desired ReplicasNumber of desired pods. This is a pointer to distinguish between explicit zero and not specified.
Minimum Ready (Seconds)Minimum number of seconds for which a newly created pod should be ready without any of its container crashing, for it to be considered available.
NameName of the Deployment.
NamespaceNamespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty. Must be a DNS_LABEL. Cannot be updated.
Observed GenerationThe generation observed by the deployment controller.
PausedIndicates that the deployment is paused.
Progress Deadline (Seconds)Indicates that the deployment is paused.
Ready ReplicasTotal number of ready pods targeted by this deployment.
RegionThe AWS Region this object belongs to.
ReplicasTotal number of non-terminated pods targeted by this deployment (their labels match the selector).
Revision History LimitThe number of old ReplicaSets to retain to allow rollback. This is a pointer to distinguish between explicit zero and not specified.
StrategyType of deployment.
Unavailable ReplicasTotal number of unavailable pods targeted by this deployment. This is the total number of pods that are still required for the deployment to have 100% available capacity. They may either be pods that are running but not yet available or pods that still have not been created.
Updated ReplicasTotal number of non-terminated pods targeted by this deployment that have the desired template spec.

Job

NameDescription
Active Deadline (Seconds)Specifies the duration in seconds relative to the startTime that the job may be active before the system tries to terminate it; value must be positive integer
Active PodsThe number of actively running pods.
Backoff LimitSpecifies the number of retries before marking this job failed.
Completion TimeRepresents time when the job was completed. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC.
CompletionsSpecifies the desired number of successfully finished pods the job should be run with. Setting to nil means that the success of any pod signals the success of all pods, and allows parallelism to have any positive value. Setting to 1 means that parallelism is limited to 1 and the success of that pod signals the success of the job.
Failed PodsThe number of pods which reached phase Failed.
Manual SelectorControls generation of pod labels and pod selectors. Leave manualSelector unset unless you are certain what you are doing. When false or unset, the system pick labels unique to this job and appends those labels to the pod template. When true, the user is responsible for picking unique labels and specifying the selector. Failure to pick a unique label may cause this and other jobs to not function correctly.
NameName of the Job.
NamespaceNamespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty. Must be a DNS_LABEL. Cannot be updated.
ParallelismSpecifies the maximum desired number of pods the job should run at any given time. The actual number of pods running in steady state will be less than this number when ((.spec.completions - .status.successful) < .spec.parallelism), i.e. when the work left to do is less than max parallelism.
RegionThe AWS Region this object belongs to.
Start TimeRepresents time when the job was acknowledged by the job controller. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC.
Succeeded PodsThe number of pods which reached phase Succeeded.

Namespace

NameDescription
Average CPU Usage (Nanocores)The current average CPU usage per pod in this Namespace.
Average Memory Usage (Bytes)The current average memory usage per pod in this Namespace.
Failed Pod CountThe current number of pods hosted by this Namespace in a Failed phase.
NameName of the Namespace.
Not Ready Pod CountThe current number of pods hosted by this Namespace in a Not Ready condition.
Pending Pod CountThe current number of pods hosted by this Namespace in a Pending phase.
PhaseCurrent condition of the Namespace.
Pod CountThe current number of pods hosted by this Namespace.
Ready Pod CountThe current number of pods hosted by this Namespace in a Ready condition.
RegionThe AWS Region this object belongs to.
Running Not Ready Pod CountThe current number of pods hosted by this Namespace in a Running phase, but not a Ready condition.
Running Pod CountThe current number of pods hosted by this Namespace in a Running phase.
Succeeded Pod CountThe current number of pods hosted by this Namespace in a Succeeded phase.
Total CPU Usage (Nanocores)The current CPU usage over all pods in this Namespace.
Total Memory Usage (Bytes)The current memory usage over all pods in this Namespace.
Unknown Pod CountThe current number of pods hosted by this Namespace in an Unknown condition.

Node

NameDescription
Allocatable CPU (Nanocores)The amount of memory on the Node available for scheduling.
Allocatable Memory (Bytes)The amount of memory on the Node available for scheduling.
Allocatable PodsThe number of pods available for scheduling.
ArchitectureThe Architecture reported by the Node.
Available Memory (Bytes)Available memory for use. This is defined as (Total Memory - Working Set Usage).
Available Space (Bytes)The storage space available for the filesystem.
Container Runtime VersionContainerRuntime Version reported by the Node through runtime remote API.
Containers CPU Limit (Nanocores)The maximum CPU usage the containers on this node are allowed to consume.
Containers CPU Request (Nanocores)The minimum CPU usage required by the containers on this node.
Containers Memory Limit (Bytes)The maximum Memory usage the containers on this node are allowed to consume.
Containers Memory Request (Bytes)The minimum memory required by the containers on this node.
CPU Capacity (Nanocores)Total CPU capacity of the Node.
CPU Time (Nanoseconds)Cumulative CPU time (sum of all cores) since object creation.
CPU Usage (Nanocores)Total CPU usage (sum of all cores) averaged over the sample window.
CPU Usage Ratio (%)Total CPU usage (sum of all cores) averaged over the sample window.
Creation TimestampA timestamp representing the server time when Node object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value.
External IDExternal ID of the Node assigned by some machine database (e.g. a cloud provider).
External IPThe external IP address of the Node.
Failed Pod CountThe current number of pods hosted by this Node in a Failed phase.
Five Minute EvictionsThe number of Pods evicted from this node in the last five minutes.
Free inodesThe number of free inodes in the filesystem.
HostnameThe hostname of the Node.
Internal IPThe internal IP address of the Node.
Is MasterIndicates if the Node is hosting master components (kube-apiserver, kube-controller-manager, kube-scheduler).
Kernel VersionKernel Version reported by the Node from 'uname -r'.
Kubelet VersionKubelet Version reported by the Node.
KubeProxy VersionKubeProxy Version reported by the Node.
Machine IDMachineID reported by the Node. For unique machine identification in the cluster this field is preferred.
Major Page FaultsCumulative number of major page faults.
Memory Usage (Bytes)Total memory in use. This includes all memory regardless of when it was accessed.
Memory Usage Ratio (%)Total memory in use. This includes all memory regardless of when it was accessed.
Minor Page FaultsCumulative number of minor page faults.
Not Ready Pod CountThe current number of pods hosted by this Node in a Not Ready condition.
Operating SystemThe Operating System reported by the Node.
OS ImageOS Image reported by the Node from /etc/os-release.
Pending Pod CountThe current number of pods hosted by this Node in a Pending phase.
Pod CapacityTotal pod capacity of the Node.
Pod CountThe current number of pods hosted by this Node.
Provider IDID of the Node assigned by the cloud provider in the format: ://.
ReadyTrue if the node is healthy and ready to accept pods, False if the node is not healthy and is not accepting pods, and Unknown if the node controller has not heard from the node in the last 40 seconds
Ready Pod CountThe current number of pods hosted by this Node in a Ready condition.
Receive Errors (Errors)Cumulative count of receive errors encountered.
Received Data (Bytes)Cumulative amount of data received.
RegionThe AWS Region this object belongs to.
RSS Usage (Bytes)The amount of anonymous and swap cache memory (includes transparent hugepages).
Running Not Ready Pod CountThe current number of pods hosted by this Node in a Running phase, but not a Ready condition.
Running Pod CountThe current number of pods hosted by this Node in a Running phase.
Succeeded Pod CountThe current number of pods hosted by this Node in a Succeeded phase.
Total inodesThe total number of inodes in the filesystem.
Total Memory (Bytes)Total memory capacity of the Node.
Total Space (Bytes)The total capacity of the filesystems underlying storage.
Transmit Errors (Errors)Cumulative count of transmit errors encountered.
Transmitted Data (Bytes)Cumulative amount of data transmitted.
UIDUID of the Node.
Unknown Pod CountThe current number of pods hosted by this Node in an Unknown condition.
Used inodesThe number of inodes used by the filesystem.
Used Space (Bytes)The storage space used on the filesystem.
Used Space Ratio (%)The storage space used on the filesystem.
Working Set Usage (Bytes)The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory.

Pod

NameDescription
Available Ephemeral Space (Bytes)The ephemeral storage space available.
Available Memory (Bytes)Available memory for use. This is defined as (Memory Limit - Working Set Usage). If Memory Limit is undefined, this metric is not returned.
ComponentThe component label of the Pod.
CPU Limit (Nanocores)The maximum CPU usage the containers on this pod are allowed to consume.
CPU Limit Usage (%)The total CPU Usage in proportion to the CPU Limit.
CPU Request (Nanocores)The minimum CPU usage required by the containers on this pod.
CPU Request Usage (%)The total CPU Usage in proportion to the CPU Request.
CPU Time (Nanoseconds)Cumulative CPU time (sum of all cores) since object creation.
CPU Usage (Nanocores)Total CPU usage (sum of all cores) averaged over the sample window.
DNS PolicyThe DNS policy for the Pod. Defaults to "ClusterFirst". Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. To have DNS options set along with hostNetwork, you have to specify DNS policy explicitly to 'ClusterFirstWithHostNet'. Note that 'None' policy is an alpha feature introduced in v1.9 and CustomPodDNS feature gate must be enabled to use it.
Free Ephemeral inodesThe number of free ephemeral inodes.
Host IP AddressIP address of the host to which the pod is assigned. Empty if not yet scheduled.
Major Page FaultsCumulative number of major page faults.
Memory Limit (Bytes)The maximum memory usage the containers on this pod are allowed to consume.
Memory Limit Usage (%)The total Memory Usage in proportion to the Memory Limit.
Memory Request (Bytes)The minimum memory required by the containers on this pod.
Memory Request Usage (%)The total Memory Usage in proportion to the Memory Request.
Memory Usage (Bytes)Total memory in use. This includes all memory regardless of when it was accessed.
Minor Page FaultsCumulative number of minor page faults.
NameName of the Pod.
NamespaceNamespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty. Must be a DNS_LABEL. Cannot be updated.
PhaseCurrent condition of the Pod.
Pod IP AddressIP address allocated to the pod. Routable at least within the cluster. Empty if not yet allocated.
QoS ClassThe Quality of Service (QoS) classification assigned to the Pod based on resource requirements.
ReadyTrue if all containers on this Pod are in a ready state.
RegionThe AWS Region this object belongs to.
Restart CountThe number of times Containers running on this Pod have restarted.
Restart PolicyRestart policy for all containers within the Pod. One of Always, OnFailure, Never. Default to Always.
RSS Usage (Bytes)The amount of anonymous and swap cache memory (includes transparent hugepages).
Total Ephemeral inodesThe total number of ephemeral inodes.
Total Ephemeral Space (Bytes)The total ephemeral storage capacity.
Used Ephemeral inodesThe number of ephemeral inodes used.
Used Ephemeral Space (Bytes)The ephemeral storage space used.
Used Ephemeral Space Ratio (%)The ephemeral storage space used.
Working Set Usage (Bytes)The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory.

Volume

NameDescription
Available Space (Bytes)The storage space available of this volume.
Free inodesThe number of free inodes in this volume.
NameName of the Volume.
RegionThe AWS Region this object belongs to.
Total inodesThe total number of inodes in this volume.
Total Space (Bytes)The total storage capacity of this volume.
TypeThe type of the volume.
Used inodesThe number of inodes used in this volume.
Used Space (Bytes)The storage space used of this volume.

Updated 8 months ago

Amazon EKS


Elastic Container Service for Kubernetes

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.