Telemetry & Observability

Comprehensive telemetry and observability are essential for operating Geode in production. Geode provides built-in instrumentation, metrics export, structured logging, and distributed tracing support for understanding system behavior, identifying performance bottlenecks, and troubleshooting issues efficiently. <h3 id="metrics-collection" class="position-relative d-flex align-items-center group"> Metrics Collection <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="metrics-collection" aria-haspopup="dialog" aria-label="Share link: Metrics Collection"> Share link </button> </h3><div id="headingShareModal" class="heading-share-modal" role="dialog" aria-modal="true" aria-labelledby="headingShareTitle" hidden> <div class="hsm-dialog" role="document"> <div class="hsm-header"> <h2 id="headingShareTitle" class="h6 mb-0 fw-bold">Share this section</h2> <button type="button" class="hsm-close" aria-label="Close"> </button> </div> <div class="hsm-body"> <label for="headingShareInput" class="form-label small text-muted mb-1 text-uppercase fw-bold" style="font-size: 0.7rem; letter-spacing: 0.5px;">Permalink</label> <div class="input-group mb-4 hsm-url-group"> <input id="headingShareInput" type="text" class="form-control font-monospace" readonly aria-readonly="true" style="font-size: 0.85rem;" /> <button class="btn btn-primary hsm-copy" type="button" aria-label="Copy" title="Copy"> </button> </div> <div class="small fw-bold mb-2 text-muted text-uppercase" style="font-size: 0.7rem; letter-spacing: 0.5px;">Share via</div> <div class="hsm-share-grid"> <a id="share-twitter" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Twitter </a> <a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> LinkedIn </a> <a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Facebook </a> </div> </div> </div> </div> <style> .heading-share-modal { position: fixed; inset: 0; display: flex; justify-content: center; align-items: center; background: rgba(0, 0, 0, 0.6); z-index: 1050; padding: 1rem; backdrop-filter: blur(4px); -webkit-backdrop-filter: blur(4px); } .heading-share-modal[hidden] { display: none !important; } .hsm-dialog { max-width: 420px; width: 100%; background: var(--bs-body-bg, #fff); color: var(--bs-body-color, #212529); border: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); border-radius: 1rem; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25); overflow: hidden; animation: hsm-fade-in 0.2s ease-out; } @keyframes hsm-fade-in { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } } [data-bs-theme="dark"] .hsm-dialog { background: #1e293b; border-color: rgba(255,255,255,0.1); color: #f8f9fa; } .hsm-header { display: flex; justify-content: space-between; align-items: center; padding: 1rem 1.5rem; border-bottom: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); background: rgba(0,0,0,0.02); } [data-bs-theme="dark"] .hsm-header { background: rgba(255,255,255,0.02); border-color: rgba(255,255,255,0.1); } .hsm-close { background: transparent; border: none; color: inherit; opacity: 0.5; padding: 0.25rem 0.5rem; border-radius: 0.25rem; font-size: 1.2rem; line-height: 1; transition: opacity 0.2s; } .hsm-close:hover { opacity: 1; } .hsm-body { padding: 1.5rem; } .hsm-url-group { display: flex !important; align-items: stretch; } .hsm-url-group .form-control { flex: 1; min-width: 0; margin: 0; background: var(--bs-secondary-bg, #f8f9fa); border-color: var(--bs-border-color, #dee2e6); border-top-right-radius: 0; border-bottom-right-radius: 0; height: 42px; } .hsm-url-group .btn { flex: 0 0 auto; margin: 0; margin-left: -1px; border-top-left-radius: 0; border-bottom-left-radius: 0; height: 42px; display: flex; align-items: center; justify-content: center; padding: 0 1.25rem; z-index: 2; } [data-bs-theme="dark"] .hsm-url-group .form-control { background: #0f172a; border-color: #334155; color: #e2e8f0; } .hsm-share-grid { display: flex; flex-direction: column; gap: 0.5rem; } .hsm-share-grid .btn { display: flex; align-items: center; justify-content: center; font-size: 0.9rem; padding: 0.6rem; border-color: var(--bs-border-color); width: 100%; } [data-bs-theme="dark"] .hsm-share-grid .btn { color: #e2e8f0; border-color: #475569; } [data-bs-theme="dark"] .hsm-share-grid .btn:hover { background: #334155; border-color: #cbd5e1; } </style> <script> (function(){ const modal = document.getElementById('headingShareModal'); if(!modal) return; const input = modal.querySelector('#headingShareInput'); const copyBtn = modal.querySelector('.hsm-copy'); const twitter = modal.querySelector('#share-twitter'); const linkedin = modal.querySelector('#share-linkedin'); const facebook = modal.querySelector('#share-facebook'); const closeBtn = modal.querySelector('.hsm-close'); let lastFocus=null; let trapBound=false; function buildUrl(id){ return window.location.origin + window.location.pathname + '#' + id; } function isOpen(){ return !modal.hasAttribute('hidden'); } function hydrate(id){ const url=buildUrl(id); input.value=url; const enc=encodeURIComponent(url); const text=encodeURIComponent(document.title); if(twitter) twitter.href=`https://twitter.com/intent/tweet?url=${enc}&text=${text}`; if(linkedin) linkedin.href=`https://www.linkedin.com/sharing/share-offsite/?url=${enc}`; if(facebook) facebook.href=`https://www.facebook.com/sharer/sharer.php?u=${enc}`; } function openModal(id){ lastFocus=document.activeElement; hydrate(id); if(!isOpen()){ modal.removeAttribute('hidden'); } requestAnimationFrame(()=>{ input.focus(); }); trapFocus(); } function closeModal(){ if(!isOpen()) return; modal.setAttribute('hidden',''); if(lastFocus && typeof lastFocus.focus==='function') lastFocus.focus(); } function copyCurrent(){ try{ navigator.clipboard.writeText(input.value).then(()=>feedback(true),()=>fallback()); } catch(e){ fallback(); } } function fallback(){ input.select(); try{ document.execCommand('copy'); feedback(true);}catch(e){ feedback(false);} } function feedback(ok){ if(!copyBtn) return; const icon=copyBtn.querySelector('i'); if(!icon) return; const prev=copyBtn.getAttribute('data-prev')||icon.className; if(!copyBtn.getAttribute('data-prev')) copyBtn.setAttribute('data-prev',prev); icon.className= ok ? 'fa-duotone fa-clipboard-check':'fa-duotone fa-circle-exclamation'; setTimeout(()=>{ icon.className=prev; },1800); } function handleShareClick(e){ e.preventDefault(); const btn=e.currentTarget; const id=btn.getAttribute('data-share-target'); if(id) openModal(id); } function bindShareButtons(){ document.querySelectorAll('.h-share').forEach(btn=>{ if(!btn.dataset.hShareBound){ btn.addEventListener('click', handleShareClick); btn.dataset.hShareBound='1'; } }); } bindShareButtons(); if(document.readyState==='loading'){ document.addEventListener('DOMContentLoaded', bindShareButtons); } else { requestAnimationFrame(bindShareButtons); } document.addEventListener('click', function(e){ const shareBtn=e.target.closest && e.target.closest('.h-share'); if(shareBtn && !shareBtn.dataset.hShareBound){ handleShareClick.call(shareBtn, e); } }, true); document.addEventListener('click', e=>{ if(e.target===modal) closeModal(); if(e.target.closest && e.target.closest('.hsm-close')){ e.preventDefault(); closeModal(); } if(copyBtn && (e.target===copyBtn || (e.target.closest && e.target.closest('.hsm-copy')))) { e.preventDefault(); copyCurrent(); } }); document.addEventListener('keydown', e=>{ if(e.key==='Escape' && isOpen()) closeModal(); }); function trapFocus(){ if(trapBound) return; trapBound=true; modal.addEventListener('keydown', f=>{ if(f.key==='Tab' && isOpen()){ const focusable=[...modal.querySelectorAll('a[href],button,input,textarea,select,[tabindex]:not([tabindex="-1"])')].filter(el=>!el.hasAttribute('disabled')); if(!focusable.length) return; const first=focusable[0]; const last=focusable[focusable.length-1]; if(f.shiftKey && document.activeElement===first){ f.preventDefault(); last.focus(); } else if(!f.shiftKey && document.activeElement===last){ f.preventDefault(); first.focus(); } } }); } if(closeBtn) closeBtn.addEventListener('click', e=>{ e.preventDefault(); closeModal(); }); })(); </script>Geode exposes detailed metrics for monitoring database health and performance. <h4 id="core-metrics" class="position-relative d-flex align-items-center group"> Core Metrics <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="core-metrics" aria-haspopup="dialog" aria-label="Share link: Core Metrics"> Share link </button> </h4>Query Performance: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">geode_query_duration_seconds{quantile="0.50|0.95|0.99"} geode_query_count_total{status="success|error"} geode_query_result_rows{quantile="0.50|0.95|0.99"} </code></pre></div>Connection Pool: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">geode_pool_connections_active geode_pool_connections_idle geode_pool_connections_total geode_pool_wait_duration_seconds{quantile="0.95|0.99"} </code></pre></div>Resource Utilization: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">geode_memory_usage_bytes{type="heap|graph|index"} geode_cpu_usage_percent geode_disk_usage_bytes{type="data|wal|index"} </code></pre></div>Graph Statistics: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">geode_nodes_total{label="User|Product|..."} geode_relationships_total{type="FRIENDS_WITH|PURCHASED|..."} geode_properties_total </code></pre></div> <h3 id="prometheus-integration" class="position-relative d-flex align-items-center group"> Prometheus Integration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="prometheus-integration" aria-haspopup="dialog" aria-label="Share link: Prometheus Integration"> Share link </button> </h3>Geode natively exports metrics in Prometheus format. <h4 id="configuration" class="position-relative d-flex align-items-center group"> Configuration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="configuration" aria-haspopup="dialog" aria-label="Share link: Configuration"> Share link </button> </h4>Enable Prometheus endpoint: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Start Geode with metrics endpoint ./geode serve --metrics-port 9090 </code></pre></div>Or configure via config file: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml">[telemetry] enabled = true metrics_port = 9090 metrics_path = "/metrics" </code></pre></div> <h4 id="prometheus-scrape-config" class="position-relative d-flex align-items-center group"> Prometheus Scrape Config <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="prometheus-scrape-config" aria-haspopup="dialog" aria-label="Share link: Prometheus Scrape Config"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># prometheus.yml scrape_configs: - job_name: 'geode' static_configs: - targets: ['localhost:9090'] scrape_interval: 15s scrape_timeout: 10s </code></pre></div> <h4 id="example-metrics-output" class="position-relative d-flex align-items-center group"> Example Metrics Output <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="example-metrics-output" aria-haspopup="dialog" aria-label="Share link: Example Metrics Output"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"># HELP geode_query_duration_seconds Query execution time # TYPE geode_query_duration_seconds summary geode_query_duration_seconds{quantile="0.5"} 0.012 geode_query_duration_seconds{quantile="0.95"} 0.089 geode_query_duration_seconds{quantile="0.99"} 0.234 geode_query_duration_seconds_sum 1234.56 geode_query_duration_seconds_count 98765 # HELP geode_pool_connections_active Active database connections # TYPE geode_pool_connections_active gauge geode_pool_connections_active 42 # HELP geode_nodes_total Total number of nodes by label # TYPE geode_nodes_total gauge geode_nodes_total{label="User"} 1000000 geode_nodes_total{label="Product"} 500000 </code></pre></div> <h3 id="grafana-dashboards" class="position-relative d-flex align-items-center group"> Grafana Dashboards <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="grafana-dashboards" aria-haspopup="dialog" aria-label="Share link: Grafana Dashboards"> Share link </button> </h3>Pre-built Grafana dashboards provide visual monitoring. <h4 id="key-dashboard-panels" class="position-relative d-flex align-items-center group"> Key Dashboard Panels <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="key-dashboard-panels" aria-haspopup="dialog" aria-label="Share link: Key Dashboard Panels"> Share link </button> </h4>Query Performance: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-promql" data-lang="promql"># P95 Query Latency histogram_quantile(0.95, rate(geode_query_duration_seconds_bucket[5m]) ) # Query Throughput rate(geode_query_count_total[1m]) # Error Rate rate(geode_query_count_total{status="error"}[5m]) / rate(geode_query_count_total[5m]) </code></pre></div>Resource Utilization: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-promql" data-lang="promql"># Memory Usage geode_memory_usage_bytes / geode_memory_limit_bytes * 100 # CPU Usage rate(geode_cpu_usage_seconds_total[5m]) * 100 # Disk Usage geode_disk_usage_bytes / geode_disk_capacity_bytes * 100 </code></pre></div>Connection Pool Health: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-promql" data-lang="promql"># Pool Utilization geode_pool_connections_active / geode_pool_connections_total * 100 # Connection Wait Time histogram_quantile(0.99, rate(geode_pool_wait_duration_seconds_bucket[5m]) ) </code></pre></div> <h4 id="dashboard-import" class="position-relative d-flex align-items-center group"> Dashboard Import <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="dashboard-import" aria-haspopup="dialog" aria-label="Share link: Dashboard Import"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Download pre-built dashboard curl -O https://geodedb.com/grafana/geode-dashboard.json # Import via Grafana UI or API curl -X POST http://localhost:3000/api/dashboards/db \ -H "Content-Type: application/json" \ -d @geode-dashboard.json </code></pre></div> <h3 id="distributed-tracing" class="position-relative d-flex align-items-center group"> Distributed Tracing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="distributed-tracing" aria-haspopup="dialog" aria-label="Share link: Distributed Tracing"> Share link </button> </h3>Geode supports OpenTelemetry for distributed tracing across services. <h4 id="opentelemetry-configuration" class="position-relative d-flex align-items-center group"> OpenTelemetry Configuration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="opentelemetry-configuration" aria-haspopup="dialog" aria-label="Share link: OpenTelemetry Configuration"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"># geode.toml [telemetry.tracing] enabled = true exporter = "jaeger" # or "zipkin", "otlp" endpoint = "http://jaeger:14268/api/traces" sample_rate = 0.1 # Trace 10% of requests </code></pre></div> <h4 id="trace-context-propagation" class="position-relative d-flex align-items-center group"> Trace Context Propagation <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="trace-context-propagation" aria-haspopup="dialog" aria-label="Share link: Trace Context Propagation"> Share link </button> </h4>Geode automatically propagates trace context from client libraries: Go Client: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">import "go.opentelemetry.io/otel" ctx, span := tracer.Start(ctx, "fetch_user_network") defer span.End() // Trace context propagated to Geode rows, err := db.QueryContext(ctx, ` MATCH (u:User {id: ?})-[:FRIENDS_WITH]->(f) RETURN f `, userID) </code></pre></div>Python Client: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from opentelemetry import trace tracer = trace.get_tracer(__name__) with tracer.start_as_current_span("fetch_user_network"): # Trace context propagated automatically async with client.connection() as conn: results, _ = await conn.query( """ MATCH (u:User {id: $id})-[:FRIENDS_WITH]->(f) RETURN f """, {"id": user_id}, ) </code></pre></div> <h4 id="trace-spans" class="position-relative d-flex align-items-center group"> Trace Spans <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="trace-spans" aria-haspopup="dialog" aria-label="Share link: Trace Spans"> Share link </button> </h4>Geode creates spans for internal operations: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Service Request └─ Query Parsing (2ms) └─ Query Planning (5ms) └─ Query Execution (15ms) ├─ Index Lookup (3ms) ├─ Graph Traversal (10ms) └─ Result Serialization (2ms) └─ Response Transmission (1ms) </code></pre></div> <h3 id="structured-logging" class="position-relative d-flex align-items-center group"> Structured Logging <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="structured-logging" aria-haspopup="dialog" aria-label="Share link: Structured Logging"> Share link </button> </h3>Geode uses structured JSON logging for machine-readable logs. <h4 id="log-levels" class="position-relative d-flex align-items-center group"> Log Levels <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="log-levels" aria-haspopup="dialog" aria-label="Share link: Log Levels"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Set log level export GEODE_LOG_LEVEL=info # debug|info|warn|error # Start with specific level ./geode serve --log-level debug </code></pre></div> <h4 id="log-format" class="position-relative d-flex align-items-center group"> Log Format <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="log-format" aria-haspopup="dialog" aria-label="Share link: Log Format"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json">{ "timestamp": "2026-01-24T14:30:00.123Z", "level": "info", "message": "Query executed successfully", "query_id": "q-12345", "duration_ms": 45, "result_rows": 100, "user_id": "user-456", "client_ip": "192.168.1.100" } </code></pre></div> <h4 id="log-aggregation" class="position-relative d-flex align-items-center group"> Log Aggregation <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="log-aggregation" aria-haspopup="dialog" aria-label="Share link: Log Aggregation"> Share link </button> </h4>Forward logs to aggregation services: Loki: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># promtail.yml clients: - url: http://loki:3100/loki/api/v1/push scrape_configs: - job_name: geode static_configs: - targets: - localhost labels: job: geode __path__: /var/log/geode/*.log </code></pre></div>ELK Stack: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Forward to Elasticsearch ./geode serve --log-format json | \ filebeat -e -c filebeat.yml </code></pre></div> <h3 id="query-profiling" class="position-relative d-flex align-items-center group"> Query Profiling <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="query-profiling" aria-haspopup="dialog" aria-label="Share link: Query Profiling"> Share link </button> </h3>Detailed query profiling for performance optimization. <h4 id="profile-command" class="position-relative d-flex align-items-center group"> PROFILE Command <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="profile-command" aria-haspopup="dialog" aria-label="Share link: PROFILE Command"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">PROFILE MATCH (u:User {email: $email})-[:PURCHASED]->(p:Product) RETURN p.name, p.price ORDER BY p.price DESC LIMIT 10 </code></pre></div> <h4 id="profile-output" class="position-relative d-flex align-items-center group"> Profile Output <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="profile-output" aria-haspopup="dialog" aria-label="Share link: Profile Output"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Query Plan: 1. Index Lookup: User(email) [2ms, 1 row] 2. Expand Relationships: PURCHASED [8ms, 45 rows] 3. Project: p.name, p.price [1ms] 4. Sort: p.price DESC [3ms] 5. Limit: 10 [<1ms] Total Execution Time: 15ms Memory Allocated: 256KB Rows Processed: 45 Rows Returned: 10 Index Usage: - User.email: HIT (selectivity: 0.0001%) </code></pre></div> <h4 id="query-metrics-per-execution" class="position-relative d-flex align-items-center group"> Query Metrics per Execution <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="query-metrics-per-execution" aria-haspopup="dialog" aria-label="Share link: Query Metrics per Execution"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json">{ "query_id": "q-67890", "execution_time_ms": 15, "planning_time_ms": 2, "rows_processed": 45, "rows_returned": 10, "memory_allocated_bytes": 262144, "index_lookups": 1, "index_hits": 1, "index_misses": 0, "traversal_depth": 1 } </code></pre></div> <h3 id="performance-alerts" class="position-relative d-flex align-items-center group"> Performance Alerts <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="performance-alerts" aria-haspopup="dialog" aria-label="Share link: Performance Alerts"> Share link </button> </h3>Configure alerts for performance degradation. <h4 id="prometheus-alertmanager-rules" class="position-relative d-flex align-items-center group"> Prometheus AlertManager Rules <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="prometheus-alertmanager-rules" aria-haspopup="dialog" aria-label="Share link: Prometheus AlertManager Rules"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">groups: - name: geode_performance rules: - alert: HighQueryLatency expr: | histogram_quantile(0.99, rate(geode_query_duration_seconds_bucket[5m]) ) > 1.0 for: 5m labels: severity: warning annotations: summary: "High query latency detected" description: "P99 query latency is {{ $value }}s" - alert: HighErrorRate expr: | rate(geode_query_count_total{status="error"}[5m]) / rate(geode_query_count_total[5m]) > 0.05 for: 2m labels: severity: critical annotations: summary: "High query error rate" description: "Error rate is {{ $value | humanizePercentage }}" - alert: ConnectionPoolExhaustion expr: | geode_pool_connections_active / geode_pool_connections_total > 0.90 for: 2m labels: severity: warning annotations: summary: "Connection pool near capacity" - alert: MemoryPressure expr: | geode_memory_usage_bytes / geode_memory_limit_bytes > 0.85 for: 5m labels: severity: warning annotations: summary: "High memory usage" </code></pre></div> <h3 id="client-side-telemetry" class="position-relative d-flex align-items-center group"> Client-Side Telemetry <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="client-side-telemetry" aria-haspopup="dialog" aria-label="Share link: Client-Side Telemetry"> Share link </button> </h3>Client libraries emit telemetry for end-to-end visibility. <h4 id="go-client-metrics" class="position-relative d-flex align-items-center group"> Go Client Metrics <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="go-client-metrics" aria-haspopup="dialog" aria-label="Share link: Go Client Metrics"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">import "geodedb.com/geode/telemetry" // Enable Prometheus metrics telemetry.EnablePrometheus(":9091") // Metrics exposed: // - geode_client_queries_total // - geode_client_query_duration_seconds // - geode_client_connection_errors_total // - geode_client_pool_connections_active </code></pre></div> <h4 id="python-client-metrics" class="position-relative d-flex align-items-center group"> Python Client Metrics <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="python-client-metrics" aria-haspopup="dialog" aria-label="Share link: Python Client Metrics"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from geode_client import Client, enable_telemetry # Enable telemetry export enable_telemetry( exporter="prometheus", port=9091 ) # Metrics tracked: # - Query count and duration # - Connection pool statistics # - Error rates by type </code></pre></div> <h3 id="real-time-monitoring" class="position-relative d-flex align-items-center group"> Real-Time Monitoring <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="real-time-monitoring" aria-haspopup="dialog" aria-label="Share link: Real-Time Monitoring"> Share link </button> </h3>Stream real-time metrics for operational dashboards. <h4 id="websocket-metrics-stream" class="position-relative d-flex align-items-center group"> WebSocket Metrics Stream <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="websocket-metrics-stream" aria-haspopup="dialog" aria-label="Share link: WebSocket Metrics Stream"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Subscribe to real-time metrics wscat -c ws://localhost:3141/metrics/stream # Receives JSON messages: { "timestamp": "2026-01-24T14:30:00Z", "queries_per_second": 1250, "avg_latency_ms": 15, "active_connections": 42, "memory_usage_mb": 2048 } </code></pre></div> <h4 id="metrics-api" class="position-relative d-flex align-items-center group"> Metrics API <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="metrics-api" aria-haspopup="dialog" aria-label="Share link: Metrics API"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># HTTP endpoint for current metrics curl http://localhost:3141/metrics/current { "timestamp": "2026-01-24T14:30:00Z", "queries": { "total": 12345678, "rate_per_second": 1250, "avg_duration_ms": 15, "p95_duration_ms": 45, "p99_duration_ms": 120 }, "connections": { "active": 42, "idle": 8, "total": 50 }, "resources": { "memory_used_mb": 2048, "memory_total_mb": 4096, "cpu_percent": 45, "disk_used_gb": 120 } } </code></pre></div> <h3 id="debugging-tools" class="position-relative d-flex align-items-center group"> Debugging Tools <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="debugging-tools" aria-haspopup="dialog" aria-label="Share link: Debugging Tools"> Share link </button> </h3>Built-in tools for troubleshooting production issues. <h4 id="slow-query-log" class="position-relative d-flex align-items-center group"> Slow Query Log <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="slow-query-log" aria-haspopup="dialog" aria-label="Share link: Slow Query Log"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml">[logging] slow_query_threshold_ms = 1000 slow_query_log = "/var/log/geode/slow-queries.log" </code></pre></div>Logs queries exceeding threshold: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json">{ "timestamp": "2026-01-24T14:30:00Z", "duration_ms": 2340, "query": "MATCH (u:User)-[:FRIENDS_WITH*3..5]->(f) RETURN f", "parameters": {"user_id": "user-123"}, "rows_returned": 50000, "execution_plan": "..." } </code></pre></div> <h4 id="connection-debugging" class="position-relative d-flex align-items-center group"> Connection Debugging <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="connection-debugging" aria-haspopup="dialog" aria-label="Share link: Connection Debugging"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># List active connections ./geode admin connections list # Connection details ./geode admin connections show <connection-id> # Kill stuck connection ./geode admin connections kill <connection-id> </code></pre></div> <h4 id="query-debugging" class="position-relative d-flex align-items-center group"> Query Debugging <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="query-debugging" aria-haspopup="dialog" aria-label="Share link: Query Debugging"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Explain query execution plan ./geode shell --explain <<< "MATCH (u:User) WHERE u.email = '[email protected]' RETURN u" # Profile query performance ./geode shell --profile <<< "MATCH (u:User)-[:PURCHASED]->(p:Product) RETURN p" </code></pre></div> <h3 id="best-practices" class="position-relative d-flex align-items-center group"> Best Practices <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="best-practices" aria-haspopup="dialog" aria-label="Share link: Best Practices"> Share link </button> </h3> <h4 id="set-appropriate-alert-thresholds" class="position-relative d-flex align-items-center group"> Set Appropriate Alert Thresholds <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="set-appropriate-alert-thresholds" aria-haspopup="dialog" aria-label="Share link: Set Appropriate Alert Thresholds"> Share link </button> </h4>Tune thresholds based on baseline performance: <ul> <li>Latency alerts: p99 > 2x baseline</li> <li>Error rate alerts: >1% for critical queries</li> <li>Resource alerts: >80% utilization</li> </ul> <h4 id="sample-traces-intelligently" class="position-relative d-flex align-items-center group"> Sample Traces Intelligently <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="sample-traces-intelligently" aria-haspopup="dialog" aria-label="Share link: Sample Traces Intelligently"> Share link </button> </h4>Balance observability with overhead: <ul> <li>Production: 1-10% sampling</li> <li>Staging: 50-100% sampling</li> <li>Development: 100% sampling</li> </ul> <h4 id="retain-metrics-appropriately" class="position-relative d-flex align-items-center group"> Retain Metrics Appropriately <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="retain-metrics-appropriately" aria-haspopup="dialog" aria-label="Share link: Retain Metrics Appropriately"> Share link </button> </h4>Configure retention policies: <ul> <li>Real-time metrics: 1-7 days (high resolution)</li> <li>Historical metrics: 90 days (downsampled)</li> <li>Long-term trends: 1 year (aggregated)</li> </ul> <h4 id="monitor-client-and-server" class="position-relative d-flex align-items-center group"> Monitor Client and Server <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="monitor-client-and-server" aria-haspopup="dialog" aria-label="Share link: Monitor Client and Server"> Share link </button> </h4>Track metrics on both sides: <ul> <li>Server metrics: Query performance, resource usage</li> <li>Client metrics: Connection pool, request latency</li> <li>End-to-end tracing: Full request lifecycle</li> </ul> Comprehensive telemetry enables proactive monitoring, rapid troubleshooting, and data-driven optimization of Geode deployments. Integration with standard observability tools like Prometheus, Grafana, and OpenTelemetry provides seamless operational visibility.

Popular

Related Articles

Monitoring and Telemetry