/numaproj-demo

Demo App for Numaproj

Primary LanguageGoApache License 2.0Apache-2.0

Numaproj Assist Demo

Numaproj Assist is a tool to help you quickly detect if there's any issue with your application. It leverages large language models to analyze the application logs, Kubernetes events and pod running status to identify the root cause of the problem if there's any. The tool is running as an extension in the Argo CD UX.

Installation

The following steps install Numaproj Assist in your Kubernetes cluster, and run a demo application to show how it works.

Prerequisites

  • A Kubernetes cluster
  • kubectl CLI

Installation Steps

  1. Install Numaflow CRD
kubectl apply -k https://github.com/numaproj/numaflow/config/advanced-install/minimal-crds?ref=stable
  1. Install Prometheus if you don't have one, and configure
kubectl apply -f  https://raw.githubusercontent.com/numaproj/numalogic-prometheus/main/manifests/prerequisites/prometheus/install.yaml

2.1. [skip if you did step 2] Configure the Prometheus Rule for AIOps (Please update the your Prometheus namespace)

kubectl apply -n monitoring -f https://github.com/numaproj/numalogic-prometheus/blob/main/manifests/prerequisites/prometheus/prometheus-rules.yaml
  1. Install Argo CD and Argo rollouts
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

kubectl create namespace argo-rollouts
kubectl apply -n argo-rollouts -f https://github.com/argoproj/argo-rollouts/releases/latest/download/install.yaml
  1. Install ArgoCD Metrics Server
kubectl -n argocd apply -k https://github.com/argoproj-labs/argocd-extension-metrics/manifests?ref=main
  1. Install AIOps Anomaly pipeline
kubectl  apply -f https://raw.githubusercontent.com/numaproj/numalogic-prometheus/main/manifests/pipeline/install-numalogic-rollouts.yaml -n numalogic-rollouts
  1. Install ArgoCD Extension
kubectl apply -n argocd -f ./manifests/numaproj-assist/argocd-extn/argocd-extn-configmap.yaml
kubectl apply -n argocd -f ./manifests/numaproj-assist/argocd-extn/argocd-extn-server-cm.yaml
kubectl apply -n argocd -f ./manifests/numaproj-assist/argocd-extn/argocd-rbac-cm.yaml
kubectl patch deployment argocd-server -n argocd --patch-file ./manifests/numaproj-assist/argocd-extn/argocd-deployment-patch-numaproj-assist.yaml
  1. Install demo app

a. Create argocd application

 kubectl apply -n argocd -f  ./manifests/numaproj-assist/argocd-app/argocd-demo-app-application.yaml
 ```
b. Port forward argocd UI
```bash
kubectl -n argocd port-forward svc/argocd-server 8080:80

c. open the browser "https://localhost:8080/" username is admin To get password execute below command

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
  1. Install Numaproj Assist related components
kubectl create ns numaproj-assist

# Create a Kubernetes secret for the openai api key (replace <openai-api-key> before running the following command).
```bash
kubectl -n numaproj-assist create secret generic log-summarization-tokens --from-literal=openai-api-key='<openai-api-key>'

kubectl apply -k ./manifests/numaproj-assist
  1. Install ArgoCD numaproj Assist Backend server
kubectl apply -n numaproj-assist -f https://raw.githubusercontent.com/numaproj-labs/argocd-extn-numaproj-assist/main/manifests/install.yaml
  1. Open demo App and Argo CD server
   kubectl port-forward svc/numalogic-demo-service 8081:8080 -n rollout-numalogic-demo

Open the browser "https://localhost:8081/", then go to Argo CD, click numalogic-rollout-demo app, and check the summarized information in Numaproj Assist tab.