{"_id":"@aethyrion/observatory-cli","name":"@aethyrion/observatory-cli","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aethyrion/observatory-cli","version":"0.1.0","description":"CLI tool for Observatory - self-hosted observability platform","keywords":["observatory","observability","monitoring","opentelemetry","logs","metrics","traces","aethyrion"],"author":{"name":"Owen"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/yourusername/observatory.git","directory":"packages/cli"},"homepage":"https://github.com/yourusername/observatory#readme","bugs":{"url":"https://github.com/yourusername/observatory/issues"},"main":"dist/index.js","bin":{"observatory":"bin/observatory.js"},"scripts":{"build":"tsc","dev":"tsc --watch","test":"echo \"Tests coming soon\"","prepublishOnly":"npm run build"},"dependencies":{"commander":"^11.1.0","inquirer":"^9.2.12","chalk":"^5.3.0","ora":"^7.0.1","execa":"^8.0.1"},"devDependencies":{"@types/node":"^20.10.6","@types/inquirer":"^9.0.7","typescript":"^5.3.3"},"engines":{"node":">=18.0.0"},"_id":"@aethyrion/observatory-cli@0.1.0","_nodeVersion":"24.8.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-5/p+JXU6+qjFbqIA1q5BWy+sdSwn9IvJysprzdyOcX6kS4S/hp1h7sDj3xRpSw4tYrrnGtjUBr6Oz7EXH2Cw6w==","shasum":"a9f4dd6dda144eeb252440bb26bc59fa75bc9072","tarball":"https://registry.npmjs.org/@aethyrion/observatory-cli/-/observatory-cli-0.1.0.tgz","fileCount":16,"unpackedSize":24302,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCddaYT39LifcWD5KV3L5lzNezL3VcmEOJm2HN2xqCHRAIgbefZwdtDDmjDt9aw0pNILh5VuthM5xPWn1j3PxfYQbA="}]},"_npmUser":{"name":"aethyrion","email":"rixun@icloud.com"},"directories":{},"maintainers":[{"name":"aethyrion","email":"rixun@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/observatory-cli_0.1.0_1762568883097_0.22908762624926382"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-08T02:28:03.000Z","0.1.0":"2025-11-08T02:28:03.304Z","modified":"2025-11-08T02:28:03.622Z"},"maintainers":[{"name":"aethyrion","email":"rixun@icloud.com"}],"description":"CLI tool for Observatory - self-hosted observability platform","homepage":"https://github.com/yourusername/observatory#readme","keywords":["observatory","observability","monitoring","opentelemetry","logs","metrics","traces","aethyrion"],"repository":{"type":"git","url":"git+https://github.com/yourusername/observatory.git","directory":"packages/cli"},"author":{"name":"Owen"},"bugs":{"url":"https://github.com/yourusername/observatory/issues"},"license":"MIT","readme":"# @aethyrion/observatory-cli\n\n🔭 CLI tool for Observatory - self-hosted observability platform\n\n## Features\n\n- 🚀 Quick instrumentation of Node.js applications\n- 🔍 Auto-detects frameworks (Next.js, Express, NestJS, etc.)\n- 📦 Zero-config OpenTelemetry setup\n- 🆓 100% free and open source\n- 🔒 Self-hosted - your data stays with you\n\n## Installation\n\n```bash\n# Run without installing (recommended)\nnpx @aethyrion/observatory-cli instrument\n\n# Or install globally\nnpm install -g @aethyrion/observatory-cli\n```\n\n## Usage\n\n### Instrument Your Application\n\nAutomatically instrument your Node.js application with OpenTelemetry:\n\n```bash\n# Auto-detect framework and instrument\nnpx @aethyrion/observatory-cli instrument\n\n# Specify framework explicitly\nnpx @aethyrion/observatory-cli instrument --framework nextjs\n\n# Custom Observatory URL\nnpx @aethyrion/observatory-cli instrument --url http://192.168.1.100:3102\n\n# Custom service name\nnpx @aethyrion/observatory-cli instrument --service my-awesome-app\n```\n\n### Check Observatory Status\n\n```bash\nnpx @aethyrion/observatory-cli status\n\n# Check remote Observatory instance\nnpx @aethyrion/observatory-cli status --url http://192.168.1.100:3101\n```\n\n## Supported Frameworks\n\n- ✅ Next.js\n- ✅ Express.js\n- ✅ NestJS\n- ✅ Fastify\n- ✅ Koa\n- ✅ Generic Node.js\n\n## What Gets Instrumented?\n\nThe CLI automatically instruments:\n\n- 📝 **HTTP requests** - Request/response tracking\n- 🗄️ **Database queries** - PostgreSQL, MySQL, MongoDB, etc.\n- 🌐 **External API calls** - Fetch, axios, http/https\n- ⚡ **Performance metrics** - CPU, memory, event loop\n- 🔍 **Distributed tracing** - Full request flow across services\n\n## Requirements\n\n- Node.js 18 or higher\n- Observatory backend running (see [Observatory docs](https://github.com/yourusername/observatory))\n\n## How It Works\n\n1. **Detects** your framework from `package.json`\n2. **Installs** OpenTelemetry packages as dev dependencies\n3. **Creates** instrumentation configuration files\n4. **Tests** connection to Observatory backend\n5. **Done!** Start your app and see telemetry in Observatory\n\n## Example Output\n\n```\n🔭 Observatory Instrumentation Tool\n\n✔ Detecting framework... Detected: Next.js\n? Instrument Next.js application? Yes\n✔ Installing OpenTelemetry packages...\n✔ Creating configuration files...\n✔ Testing connection to Observatory... Connected to Observatory!\n\n✅ Instrumentation complete!\n\nNext steps:\n  1. Start your app: npm run dev\n  2. Open Observatory: http://localhost:3101\n  3. Check the services list!\n```\n\n## Part of the Aethyrion Ecosystem\n\nObservatory is part of the Aethyrion suite of free, open-source developer tools:\n\n- 🔭 **Observatory** - Observability platform (replaces Datadog/New Relic)\n- 🎨 **Helix** - AI-powered code generation\n- 💎 **Prism** - ServiceNow development tools\n\n## Documentation\n\n- Full Observatory docs: [github.com/yourusername/observatory](https://github.com/yourusername/observatory)\n- Report issues: [github.com/yourusername/observatory/issues](https://github.com/yourusername/observatory/issues)\n\n## License\n\nMIT © Owen\n\n---\n\nMade with ❤️ to make observability accessible to everyone\n","readmeFilename":"README.md","_rev":"1-ae84df3f1cf8ab1ea985f3033a3b9565"}