Parseable

<h2 align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/parseablehq/.github/main/images/logo-dark.png"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/parseablehq/.github/main/images/logo.svg"> <a href="https://www.parseable.com" target="_blank"><img src="https://raw.githubusercontent.com/parseablehq/.github/main/images/logo.svg" alt="Parseable logo" /></a> </picture> </h2> <div align="center">

Key Concepts | Features | Documentation | Demo | FAQ

</div>

Parseable is a full-stack observability platform built to ingest, analyze and extract insights from all types of telemetry (MELT) data. You can run Parseable on your local machine, in the cloud, or use Parseable Cloud — the fully managed service. To experience Parseable UI, checkout app.parseable.com ↗︎.

<div align="center"> <h3> <a href="https://app.parseable.com">Try Parseable Cloud — Start Free ↗︎</a> </h3> <p><i>The fastest way to get started. No infrastructure to manage.</i></p> </div> <div align="center"> <a href="http://www.youtube.com/watch?feature=player_embedded&v=gYn3pFAfrVA" target="_blank"> <img src="http://img.youtube.com/vi/gYn3pFAfrVA/mqdefault.jpg" alt="Watch the video" width="300" height="240" /> </a> </div>

Quickstart :zap:

Run Parseable

<details> <summary><a href="https://www.parseable.com/docs/quickstart/docker">Docker Image</a></summary> <p>

Get started with Parseable Docker image with a single command:

docker run -p 8000:8000 \
  parseable/parseable:latest \
  parseable local-store

</p> </details> <details> <summary><a href="https://www.parseable.com/docs/quickstart/binary">Executable Binary</a></summary> <p>

Download and run the Parseable binary on your laptop:

• Linux or MacOS

curl -fsSL https://logg.ing/install | bash

• Windows

powershell -c "irm https://logg.ing/install-windows | iex"

</p> </details>

Ingestion and query

Once you have Parseable running, ingest data with the below command. This will send logs to the demo stream. You can see the logs in the dashboard.

curl --location --request POST 'http://localhost:8000/api/v1/ingest' \
--header 'X-P-Stream: demo' \
--header 'Authorization: Basic YWRtaW46YWRtaW4=' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "id": "434a5f5e-2f5f-11ed-a261-0242ac120002",
        "datetime": "24/Jun/2022:14:12:15 +0000",
        "host": "153.10.110.81"
    }
]'

Access the UI at http://localhost:8000 ↗︎. You can login to the dashboard default credentials admin, admin.

Getting started :bulb:

For quickstart, refer the quickstart section ↗︎.

This section elaborates available options to run Parseable in production or development environments.

• Distributed Parseable on Kubernetes: Helm Installation.
• Distributed Parseable on AWS EC2 / VMs / Linux: Binary Installation.

Features :rocket:

• High availability & Cluster mode ↗︎
• Smart cache ↗︎
• Alerts ↗︎
• Role based access control ↗︎
• OAuth2 support ↗︎
• OpenTelemetry support ↗︎

Adopters :handshake:

Organizations using Parseable in production. Add yours here — no fork needed!

<!-- ADOPTERS:START -->

| Organization | Description of Use | | --- | --- | | HireXL | Frontend application logging | | Elfsquad | Centralized application/infrastructure logging |

<!-- ADOPTERS:END -->

Verify images :writing_hand:

Parseable builds are attested for build provenance and integrity using the attest-build-provenance action. The attestations can be verified by having the latest version of GitHub CLI installed in your system. Then, execute the following command:

gh attestation verify PATH/TO/YOUR/PARSEABLE/ARTIFACT-BINARY -R parseablehq/parseable

Contributing :trophy:

<a href="https://github.com/parseablehq/parseable/graphs/contributors"><img src="https://contrib.rocks/image?repo=parseablehq/parseable" /></a>

Contribution guide ↗︎