🔍 FuncTrace Analyzer

中文版 | English Version

🌟 Project Overview

FuncTrace Analyzer is a professional Go function tracing analysis tool that helps developers deeply understand function call relationships and performance bottlenecks through visualization technologies. The system combines the efficient Kratos framework backend with a dynamic Vue.js frontend, providing a complete solution from data collection to 3D visualization.

🚀 Core Features

• Intelligent Function Tracing - Real-time goroutine execution path capture
• Multi-dimensional Analysis - Time dimension, call depth, resource consumption analysis
• Interactive Visualization - Dynamic zoomable Mermaid flowcharts + parameter heatmaps
• Smart Diagnostics - Performance bottleneck prediction based on historical data
• Cross-platform Support - Lightweight SQLite storage solution

🎯 Design Goals

1. Low-overhead Monitoring - Under 5% performance overhead
2. Zero-Intrusive Integration - No code modification required
3. Millisecond Response - Fast query for 10M+ call chains
4. Production-ready - Rigorously stress-tested

🛠️ Technology Stack

🧩 Feature Modules

1. Smart Trace Viewer

• Description: Search and display goroutines related to specific functions
• Component: TraceViewer.vue
• Details:
  • Dynamic filtering with input and dropdown
  • API integration for GID retrieval
  • Fuzzy search using fuse.js

2. 3D Call Graph Visualization

• Description: Detailed trace analysis for specific GIDs
• Component: TraceDetails.vue
• Details:
  • Parameter inspection capabilities
  • Interactive timeline navigation

3. Parameter Heatmap Analysis

• Description: Visualize function call relationships
• Component: MermaidViewer.vue
• Details:
  • Mermaid.js rendering
  • Zoom/drag support

4. Database Operations

• Description: SQLite data storage/query
• Details:
  • Data struct encapsulation
  • CRUD operations for trace data

5. CORS Support

• Description: Cross-origin resource sharing
• Details: CORS middleware configuration

🚀 Quick Start

Prerequisites

• Go 1.19+
• Node.js 16+
• SQLite3 3.36+

Backend Setup

# Clone repository
git clone https://github.com/toheart/goanalysis.git

# Start server
go run cmd/server/server.go

📡 API Reference

🤝 Contributing

We follow Gitflow workflow:

1. Create feature branch: git checkout -b feature/your-feature
2. Commit atomic changes (follow Conventional Commits)
3. Write unit tests (≥80% coverage)
4. Update documentation
5. Create PR to develop branch

GitHub Actions Pipeline and Docker Images

This project has configured a GitHub Actions pipeline for automatically building and publishing Docker images and packages.

Automatic Build Process

When code is pushed to the main branch or a new tag (in the format of v*, such as v1.0.0) is created, the build process is automatically triggered:

1. Checkout code
2. Set up Go environment
3. Retrieve version information
4. Sync frontend code (from the latest release version of https://github.com/toheart/goanalysis-web)
5. Build application
6. Package Linux and Windows versions
7. Build and push Docker image (only when pushing to a branch or tag)
8. Create GitHub Release (only when creating a tag)

Frontend Version Synchronization

The system will automatically fetch the latest release version from the https://github.com/toheart/goanalysis-web repository for building:

1. Retrieve the latest release version information via GitHub API
2. Download the corresponding release package or source code
3. If the release package contains a compiled dist directory, use it directly
4. If only the source code is available, it will be compiled automatically
5. The Release notes will include the frontend version information used

Using Docker Images

Docker images have been published to the GitHub Container Registry and can be pulled using the following command:

📜 Version History

📞 Contact

• Maintainer: toheart
• Issues: GitHub Issues
• WeChat: 小唐云原生