Samarithan
WhatsApp Business is a tool designed to aid enterprises in reaching, communicating and building relationships with their customers. It extends the core features...
Last verified:
What is Samarithan?
Samarithan is a lightweight Node.js library for incident management, structured logging, and on-call support. It automatically captures errors and exceptions in your application, logs them with context, and transforms them into actionable incidents that can be assigned severity levels and tracked.
Key features include automatic error logging via logAll(), exception capture with captureException(), and manual incident creation through createIncident(). The library integrates with your existing Node.js codebase without major refactoring, letting you wrap try/catch blocks or use it as a global error handler. It requires an API key obtained from the Samarithan dashboard after signing up on their website.
Samarithan is designed for small to mid-sized engineering teams, startups, and DevOps professionals who need simple, no-frills incident tracking without the overhead of large enterprise APM platforms. It is particularly useful for monitoring payment systems, microservices, and other critical backend components where fast error detection and incident creation are essential.
Samarithan pricing
Pricing model: Free
Samarithan is currently free to use as an open-source npm package under the MIT License. The library itself has no subscription fees. Access to the Samarithan API and dashboard (required for obtaining an API key and viewing incidents) is available after signing up on their website. No paid tiers or enterprise plans are publicly advertised at this time.
Samarithan pros
- Automatic error and exception logging
- Simple npm/yarn installation
- Lightweight Node.js library
- Manual incident creation with custom title, description, and severity
- No major code refactoring required
- Flexible error handling customization
- Ideal for monitoring critical services like payment systems
- Structured logging with app context
- Try/catch integration for targeted error capture
- Global error logging support
- Clear API configuration with apiKey
- Suitable for small to mid-sized teams
- Fast incident creation workflow
- Works well with microservices architectures
- MIT licensed with open contribution
Samarithan cons
- No built-in UI dashboard (rely on external tools)
- Requires manual API key setup
- Limited documentation compared to enterprise APM tools
- No native alerting or on-call rotation features
- No multi-language support (Node.js only)
- Small user base and community
- No advanced analytics or trend reporting
- Basic error handling (no auto-context enrichment)
Frequently asked questions about Samarithan
What is Samarithan used for?
Samarithan is used for incident management, structured logging, and on-call support in Node.js applications. It captures errors and exceptions, logs them with context, and allows you to create incidents with custom titles, descriptions, and severity levels for faster troubleshooting and team coordination.
How do I install Samarithan?
You can install Samarithan via npm or yarn by running 'npm install samarithan' or 'yarn add samarithan' in your project directory. After installation, you configure it with your API key using sam.configure({ apiKey: 'your-api-key' }).
Do I need an API key to use Samarithan?
Yes, you must sign up on the Samarithan website to obtain an API key from your dashboard. This key is required to configure the library and make API requests for logging and incident creation.
Can Samarithan automatically log all errors in my app?
Yes, Samarithan provides a logAll() method that can be configured with your app name to automatically capture and log errors and exceptions across your application, reducing the need for manual try/catch blocks in every location.
How do I create an incident with Samarithan?
You create an incident by defining an object with title, description, and severity (e.g., 'High'), then calling await sam.createIncident(incident). If successful, the function returns true and the incident is registered in your Samarithan account.
Does Samarithan support multiple applications?
Yes, Samarithan allows you to specify an app name when logging errors or creating incidents, enabling you to distinguish between different applications or services within the same Samarithan account.
What programming languages does Samarithan support?
Samarithan is a Node.js library and currently only supports JavaScript/TypeScript applications running on Node.js. There are no official versions for Python, Java, or other languages at this time.
Can I customize error handling in Samarithan?
Yes, Samarithan provides basic error handling for API requests but allows you to customize error handling logic to suit your application's needs, such as logging additional context or integrating with other monitoring tools.
Is Samarithan free to use?
The Samarithan npm package is free and open-source under the MIT License. Access to the Samarithan API and dashboard requires signing up on their website, but no paid plans or subscription fees are currently advertised.
How do I contribute to Samarithan?
Contributions are welcome for bug reports, feature suggestions, and code improvements. You can check the contribution guidelines on the Samarithan repository or NpmJS page to learn how to submit pull requests or report issues.