Skip to main content

Quick Start Guide

Get up and running with Brewry in minutes. This guide will walk you through the essential steps to start collecting and visualizing your telemetry data.

Prerequisites

Before you begin, ensure you have:

  • A Brewry account (Sign up at dashboard.brewry.xyz)
  • Your devices (Racks) ready to send data
  • Basic understanding of your data structure

Step 1: Create Your First Cellar

  1. Log in to your Brewry dashboard
  2. Click "New Cellar" in the top navigation
  3. Enter a Cellar name and description and click "Create Cellar".
  4. Navigate to the API Keys tab for the cellar, and copy the API key generated for this cellar.
  5. Save your Cellar's API key securely - you'll need it for data ingestion

Step 2: Set Up Your Racks

Racks are physical devices or sensors that collect and transmit data to the Brewry platform. They are automatically registered in the system when they first send data. Each Rack requires an internet connection to communicate with Brewry's servers.

Key points about Racks:

  • A Rack represents a physical device or sensor in your system
  • Each Rack has a unique identifier
  • A Rack can send data to multiple Cellars
  • Racks are responsible for collecting and sending their data

Step 3: Send Data to Your Cellar

To begin data ingestion, you'll need to implement the API integration between your Racks and Brewry's servers. For detailed implementation guidance, including API endpoints, authentication, and data format specifications, refer to the pushing data documentation in the API section.

  • Use the Cellar's API key and Rack ID to send data
  • Sensor data sent to a Cellar is called a Keg
  • You can send multiple Kegs from the same Rack
  • Data can be sent using our REST API or SDKs, check for Supported SDKs for your device.

Step 4: Verifying Ingestion

Brewry dashboard automatically refreshes at regular intervals to display the most up-to-date sensor data and analytics. This real-time update feature ensures you always have access to the latest information without manual intervention.

Best Practices

  • Keep your Cellar API keys secure
  • Use meaningful names for your Racks
  • Monitor your data ingestion rates
  • Regularly review your alert thresholds
  • Document your Rack configurations

Need Help?

If you encounter any issues or need assistance: