Aman Pandae b8b8aec624 Helm image Sync with Updated Docker Hub tag
following the image tagging process on Docker Hub,
The image version within the Helm repository has
been updated to match the newly created tag
stx.10.0-v1.0.2
Version updated after bugfix and CVE fix

Test plan:
PASSED: Build process is successful with creation of debian package.
PASSED: Unpack the Debian package and verify if the Helm chart
        tar file exists.
PASSED: Using 'system application' commands in AIO-SX env app was
        uploaded, applied, removed, and ultimately deleted without
        errors.
PASSED: After installation, verified App responded on
        http://localhost:9110.
PASSED: Deleting "All" removed the associated Helm chart and all
        K8s resources.
PASSED: Verified API output for Gauge in all PFs and VFs

Depends-On: https://review.opendev.org/c/starlingx/root/+/924112

Story: 2010918
Task: 50582

Change-Id: I2c55648c7e26c99e2d43958e21bfa5e03304fce3
Signed-off-by: Aman Pandae <AmanPandae.Mothukuri@windriver.com>
2024-07-13 08:43:47 -04:00
2023-12-13 14:40:02 -07:00
2023-09-14 12:33:40 +00:00
2023-12-13 14:40:02 -07:00

app-node-interface-metrics-exporter

app-node-interface-metrics-exporter flux cd app

Top Level Directory Structure

├── app-node-interface-metrics-exporter    # Root Folder
│   ├── debian_build_layer.cfg
│   ├── debian_iso_image.inc
│   ├── debian_pkg_dirs
│   ├── metrics-exporter-api              # Go code  for  api server which will expose  Metrics for  NIC .
│   ├── python3-k8sapp-node-interface-metrics-exporter    # lifecycle managemnt code  to support  flux apps
│   ├── README.md
│   ├── requirements.txt
│   ├── stx-node-interface-metrics-exporter      # helm Package manager  for the app
│   ├── test-requirements.txt
│   └── tox.ini

all command related to go code should run from app-node-interface-metrics-exporter/metrics-exporter-api/docker/metrics-exporter-api

About metrics-exporter-api

It is Simple Http Server which reads network interface (PCI devices) and exposes following API's

  1. http://{hostname}:{port}/metrics -- all node metrics in OpenMetrics format
  2. http://{hostname}:{port}/metrics/device/{DeviceName} -- specified interface metrics identified by device name in OpenMetrics format
  3. http://{hostname}:{port}/metrics/pci-addr/{PciAddr} -- specified interface metrics identified by PCI address in OpenMetrics format
  4. http://{hostname}:{port}/json/metrics -- all node metrics in JSON format
  5. http://{hostname}:{port}/json/metrics/device/{DeviceName} -- specified interface metrics identified by device name in JSON format
  6. http://{hostname}:{port}/json/metrics/pci-addr/{PciAddr} -- specified interface metrics identified by PCI address in JSON format

Makefile Support

$ make
help:                Show this help.
install_dep:         install go dependency
run:                 run app on host machine
test:                run go unit test
testcov:             run go coverage test
vet:                 run go vet
lint:                run go lint
build_linux:         Build application
build_image:         Build docker image

$ make run will start go dev http server

Run time Options / params for the metrics-exporter-app usage

Options Help
-log.file Log file name (default "node_metrics_api.log")
-log.level log level. (default "info"). Valid options trace, debug, info, warning, error, fatal and panic
-log.file Log file name (default "node_metrics_api.log")
-web.listen-address Port to listen on for web interface. (default ":9110")
-path.sys mounted path for host /sys inside container (default "/sys")

Local / Devlopment Set UP for metrics-exporter-api

pre requisite go 1.21.0

Container image reference for helm

Dockerfile

Build Reference

References

StarlingX

How to add a FluxCD App to Starlingx

OpenMetrics

Description
StarlingX Node Interface Metrics Exporter App
Readme 20 MiB
Languages
Go 69%
Python 21.8%
Makefile 7.8%
Dockerfile 1.3%