Monitoring & Observability

🩺
Microservices Health Check
Real-time status of all Hayley microservices across environments
Monitoring endpoint active
Open Health Dashboard ↗
🔬
Deep Observability — LangFuse
LLM traces, prompt analytics, latency, cost tracking, and evaluation scores across all Hayley agents
Requires LangFuse project credentials
Open LangFuse ↗Docs ↗
☁️
GCP Log Explorer
Cloud logging for PROD & STG — filter by pod label k8s-pod/app
Project: gds-prototype-20190629
Open Log Explorer ↗
🕸️
Knowledge Graph Environments
Access the KG UI across QA, STG, and PROD. Navigate to HayleyChat → Knowledge Base after login.
Credentials: request from Tin
QA ↗STG ↗PROD ↗

Environment Variables

Copy the variables below into your local .env file. Required vars must be set before running any service.
🌐 Shared — All Services
# shared.env
HAYLEY_ENVqa required# qa | stg | prod
HAYLEY_LOG_LEVELinfo optional# debug | info | warn | error
NOTION_API_KEYsecret_... required# Notion integration secret
OPENAI_API_KEYsk-proj-... required# Project: Responses Agent
OPENAI_PROJECT_IDproj_... required# OpenAI project ID
LANGFUSE_PUBLIC_KEYpk-lf-... required# Deep observability
LANGFUSE_SECRET_KEYsk-lf-... required# Deep observability
LANGFUSE_HOSThttps://cloud.langfuse.com optional# Override for self-hosted
REPORTING_DB_ID2b61db9b... required# Notion DB — benchmark factory
CHATDB_ID1df1db9b... required# Notion DB — conversation DB
🚀 Hayley Engine
# hayley-engine.env
ENGINE_PORT8080 optional# Default 8080
ENGINE_BASE_URLhttps://engine.hayley... required# Internal service URL
ORCHESTRATOR_URLhttps://orchestrator.hayley... required# Agent orchestrator endpoint
ENGINE_MAX_TOKENS4096 optional# LLM context limit
ENGINE_TIMEOUT_MS30000 optional# Request timeout
🎭 Agent Orchestrator
# agent-orchestrator.env
ORCHESTRATOR_PORT8081 optional# Default 8081
NODE_RETRIEVAL_URLhttps://node-retrieval.hayley... required# Downstream service
RAG_RETRIEVAL_URLhttps://rag-retrieval.hayley... required# Downstream service
FIXED_RESPONSE_URLhttps://fixed-response.hayley... required# Downstream service
SPF_GENERATOR_URLhttps://spf-generator.hayley... required# Downstream service
TTH_URLhttps://translate-human.hayley... required# Translate to Human
IF_MESH_VERSION1.0 required# Active IF-Mesh version
🕸️ Property Knowledge Graph
# property-kg.env
KG_DB_URLneo4j://... required# Graph database connection
KG_DB_USERneo4j required# DB username
KG_DB_PASSWORD****** required# Request from Tin
KG_PORT8082 optional# Default 8082
KG_ENVIRONMENTqa required# qa | stg | prod
💬 Chat, Mail & Voice Adapters
# adapters.env
CHAT_ADAPTER_PORT8083 optional# Hayley Chat adapter
MAIL_ADAPTER_PORT8084 optional# Hayley Mail adapter
VOICE_ADAPTER_PORT8085 optional# Hayley Voice adapter
TWILIO_ACCOUNT_SIDAC... required# Voice — Twilio credentials
TWILIO_AUTH_TOKEN****** required# Voice — Twilio auth
SENDGRID_API_KEYSG.... required# Mail — email delivery
PROPERTY_ID1806726119474622216 required# Target property for testing

Quick Reference

📋 Notion Docs

Microservices I/O↗IF-Mesh Framework↗KG Taxonomy DEV↗KG Tracker Database↗

🔑 Access & Credentials

KG Environments (QA/STG/PROD): Request credentials from Tin
QA Logs: SSH access to server
LangFuse: Request project credentials from team