{"id":31580946,"url":"https://github.com/platformbuilds/telegen","last_synced_at":"2026-02-05T12:01:01.338Z","repository":{"id":310044661,"uuid":"1038493380","full_name":"platformbuilds/telegen","owner":"platformbuilds","description":"# Telegen - One Agent, Many Telemetry signals","archived":false,"fork":false,"pushed_at":"2026-01-29T18:00:03.000Z","size":120197,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-29T21:39:30.440Z","etag":null,"topics":["cncf","ebpf","observability","opentelemetry"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/platformbuilds.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-15T09:53:50.000Z","updated_at":"2025-08-15T18:26:46.000Z","dependencies_parsed_at":"2025-08-15T12:08:02.190Z","dependency_job_id":"32fb789d-f3bc-498d-a3c1-b8377e063d56","html_url":"https://github.com/platformbuilds/telegen","commit_stats":null,"previous_names":["platformbuilds/telegen"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/platformbuilds/telegen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platformbuilds%2Ftelegen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platformbuilds%2Ftelegen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platformbuilds%2Ftelegen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platformbuilds%2Ftelegen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/platformbuilds","download_url":"https://codeload.github.com/platformbuilds/telegen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/platformbuilds%2Ftelegen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29121678,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T10:47:47.471Z","status":"ssl_error","status_checked_at":"2026-02-05T10:45:08.119Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cncf","ebpf","observability","opentelemetry"],"created_at":"2025-10-05T21:23:00.498Z","updated_at":"2026-02-05T12:01:01.331Z","avatar_url":"https://github.com/platformbuilds.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegen\n\nA unified telemetry agent for collecting and exporting metrics, traces, logs, and Java profiling data using OpenTelemetry and Prometheus protocols.\n\n**One agent, many signals.** All signal types are config-driven pipelines:\n- **Metrics:** Host metrics with Remote Write export\n- **Traces:** eBPF-based distributed tracing with OTLP export\n- **Logs:** File tailing with OTLP export\n- **JFR:** Java Flight Recorder profiling converted to JSON for OTel ingestion\n- **Grafana Dashboard:** RED + agent health with exemplar-ready panels\n- **Helm Chart:** DaemonSet + Service + ServiceMonitor + RBAC\n\n## Quick Start\n\n```bash\ngo mod tidy\nmake build\n./bin/telegen --config ./api/config.example.yaml\n# optional: make bpf  # build CO-RE BPF .o files for ringbuf path\n```\n\n## Deploy with Helm\n```bash\nhelm install telegen ./deployments/helm\n```\n\n## Docker\n```bash\nmake docker\n```\n\n## Grafana\nImport `dashboards/telegen-red-grafana.json` into Grafana. Panels include queue pressure, exporter failures, latency p90,\nand request-rate placeholders. To enable exemplars (trace links), ensure Prometheus has exemplar storage enabled and your\nOTLP traces include span IDs that your backend can reference.\n\n## Configuration\n\nAll signal pipelines are enabled/disabled via config. See `api/config.example.yaml` for the full reference.\n\n### JFR Pipeline\n\nThe JFR pipeline watches for Java Flight Recorder files and converts them to JSON for ingestion by OTel Collector's filelog receiver.\n\n```yaml\npipelines:\n  jfr:\n    enabled: true\n    input_dirs:                      # Directories to watch for .jfr files\n      - \"/var/log/jfr\"\n    recursive: true                  # Scan subdirectories (default: true)\n    output_dir: \"/var/log/jfr-json\" # Where to write converted JSON files\n    poll_interval: \"5s\"              # How often to scan for new files\n    workers: 2                       # Number of parallel conversion workers\n```\n\n#### Architecture\n```\nJava App (JFR) → /var/log/jfr/*.jfr → Telegen JFR Pipeline → /var/log/jfr-json/*.json → OTel Collector → Backend\n```\n\n## AWS Metadata (optional)\nWhen enabled, Telegen enriches traces, logs, and metrics with AWS resource attributes and labels using IMDSv2.\n\nConfig example:\n```yaml\ncloud:\n  aws:\n    enabled: true\n    timeout: \"200ms\"           # per IMDS request\n    refresh_interval: \"15m\"    # metadata cache refresh\n    collect_tags: false        # opt-in; requires IMDS instance tags enabled\n    tag_allowlist: []          # e.g., [\"app_\", \"env\"]\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplatformbuilds%2Ftelegen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplatformbuilds%2Ftelegen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplatformbuilds%2Ftelegen/lists"}