Welcome to Bleex knowlege centre

Bleex provides end to end Analytics and data innovation technologies

What is Athena?

Athena is an end to end business intelligence, analytics and data innovation platform

Integrated apps

Athena is an end to end business intelligence, analytics and data innovation platform

Getting started

Athena is an end to end business intelligence, analytics and data innovation platform

Subscription & billing

Athena is an end to end business intelligence, analytics and data innovation platform

Account Management

Athena is an end to end business intelligence, analytics and data innovation platform

API Reference

Athena is an end to end business intelligence, analytics and data innovation platform

Working with data

Athena is an end to end business intelligence, analytics and data innovation platform

Search

Overview
Before you get started
Product Walkthrough
Integrated Apps
Subscription & billing

Overview

What is Athena?

Athena is a versatile business intelligence, analytics, and data innovation platform designed to transform raw data into actionable insights.

What can Athena do?

Athena integrates seamlessly with structured data from relational databases, spreadsheets, CSVs, and web APIs, making it a unified solution for all your analytical needs.

Key Use Cases

Business Intelligence & Analytics

Generate real-time reports and dashboards to track organizational performance—from sales trends to financial health.

Athena helps you identify problems, uncover root causes, and act faster with data-driven insights.

Data Innovation

Turn any database into an analytics powerhouse with Athena’s API-first approach. Developers can rapidly build custom, data-driven applications without backend complexity.

Automated Data Pipelines

Streamline workflows for machine learning, ETL, and more. Athena automates repetitive tasks, freeing your team to focus on high-value analysis

Data Quality Management

Surface inconsistencies, duplicates, or errors in your datasets. Athena helps you clean, validate, and maintain high-quality data for accurate reporting.

Before you get started.

Best practise recommendations:

Define the various use cases for your data.
Define the data needs within your organization e.g., which departments or users require certain types of data
Define a system of user organization based on their data needs.

Product Walkthrough

Account Management

Updating your profile

Go to Settings -> Account -> Profile
Select "Personal info" and enter your details accordingly.
Click on Update "Update profile" to complete

Updating your address

Go to Settings -> Account -> Profile
Select "Address" and enter your details accordingly.
Click on "Update profile" to complete

Changing your password

Go to Settings -> Account -> Profile
Select "Password & Security" and enter password details accordingly.
Click on "Confirm password change" to complete

Updating your organization name

Go to Settings -> Account -> Profile
Select "Organisation" and enter your new organization name accordingly.
Click on "Update company name" to complete

Teams/ Groups Management

Overview

A team is an entity used to group one or more users, usually within common data needs together. A user can belong to more than one team or group.

Creating a team

Go to settings -> Account -> Teams Click on "Create new team"
Provide a name and description of the team as provided for in the form.
Optionally assign one ore more users to the team.
Click on "OK" to complete

User Management

Creating users

Go to settings -> Account -> users
Click on "Invite users"
Enter the email addresses of users you want to invite.
Click "OK" to send the invitations.
users will receive a unique "invite code" and a link to activate their account

Editing users

Go to settings -> Account -> users
Select a user from the list of users available.
Click on the menu button of the selected user row and select "Edit."
Modify user attributes as you desire, including assigning them to a group or groups.
Click on "OK" to complete.

Analytics

Overview

This section describes the core operation of the Athena for the purpose of generating reports and insights. This section is organized to reflect the natural progression of your analytics from data to dashboards

Resource permissions.

A resource is a platform entity used to provide specific capabilities. Resources include connections, models, datasets, reports, apps, dashboards, etc. All resources on the platform have a security attribute that defines their access. There are four basic access levels.

Private: Accessible only to the user who created this resource.
Public: Anyone in your organization who has an account on the platform can access this resource
Group: Anyone belonging to the selected group can access the resource.
Assigned: Only the specified user has access to this resource. When creating resources, apply the desired permission level specified above.

Connecting to your database:

Prerequisites:

Ensure your database/data warehouse is accessible from the platform. For your data security, you can whitelist our IP address (<IP>) in your firewall
Ensure that all tables in your database/data warehouse that you intend to use for analytics have a primary key.

Creating a connection:

Go to Data -> Data sources and select "database" on the top right menu
Fill the data connection parameters as provided for in the connection creation form.
Optionally input the names of tables that you would like to be used for this connection. If no input is provided, all tables in the database will be presented
Click Test and Connect to verify and establish the connection. Editing a connection
Go to Data -> Data sources and select "database" on the top right menu
Modify one or more connection parameters as provided for in the connection creation form.
Click OK to complete

Delete a connection:

Go to Data -> Data sources and select "database" on the top right menu.
Select "Database" from the top-right menu to view existing connections.
Click on the menu button of the desired connection and select "Delete"
Click "OK" to confirm deletion.

Datasets:

Overview

A dataset is a collection of one or more tables from your connection. Its primary purpose is to separate concerns and create specialized data collections for solving specific data problems (e.g., "Finance Dataset" for financial analysis, "HR Dataset" for workforce analytics).

Creating a dataset

Go to Data -> Datasets
Click on "Create a dataset"
Enter a unique name for the dataset
Select the connection to use for this dataset
If you would like to only use a subset of tables from this connection, click on "Select tables" and choose specific tables.
Click "Create Dataset" to save changes.

Editing a dataset

Go to Data -> Datasets. A list of your datasets will be presented.
Click the "Menu" button and select "Edit"
Modify the desired attributes.
Click "OK" to complete the Editing action.

Deleting a dataset

Go to Data -> Datasets. The list of your database dataset will be shown.
Click on the menu button of the desired dataset and select "Delete"
Click "OK" to confirm deletion

Models

Overview

A model is a collection of columns from one or more related tables within a dataset.

Creating a model

Go to Data -> Models
Click on "New Model"
Select the dataset from which to create the model. A model view with a list of tables and their columns will be presented.
Select the primary table. The system will automatically load any related table using "SQL JOIN" operation.
Select one more column from one or more tables presented. To unselect a column, just click on a selected column again.
Click "Save model" and fill in the form.
Click "OK" to complete.

Editing a model

Go to Data -> Models. A list of your model will be presented.
on the "Menu" button of the desired dataset and select "Edit"
Modify one or more attributes of the model.
Click "OK" to complete the Editing action.

Note: Editing a model may affect the reports built using this model. Therefore, careful analysis is recommended before making changes.

Deleting a model

Go to Data -> Models. The list of your models will be shown.
Click the "Menu" button for the desired model and select "Delete"
Click "OK" to confirm deletion

Note: Deleting a model may affect the reports built using this model. Therefore, careful analysis is recommended before making changes.

Measures

Overview

A measure is a predefined aggregation of a numeric column/field of your data model. Predefined aggregations help users explore data without having to understanding the underlying mechanics of metric generation. The system provides the following default aggregation types.

Sum: Adds values in the selected columns.
Count: Performs a count of values in the selected columns.
Max: Selects the highest value of in the selected column.
Min: Selects the smallest value of in the selected column.
Average: Computes the mean of all values in the selected column.
Cumulative sum: Performs a rolling or cumulative addition of values in the selected column. It is very useful for tracking the growth of a certain metric over time.

Creating Measures

From the model view, click on "+ Measure" in the top-right corner of the page.
Fill in the "Measures" form as presented.
Click "OK" to save.

Recommendation: Use user-friendly names for measures (e.g., "Count of Orders", "Sales Amount"). You can add as many measures to your model as you like.

Editing a measure

Load the desired model from your model list.
Select the measure you would like to edit from the list of measures.
Modify any attribute of the measure as you would like to.
Click "OK" to save changes.

Deleting a measure

Load the desired model from your model list.
Select the measure to delete.
Click "Delete"
Click "OK" to confirm

Note: Deleting a measure may affect model capabilities and dependent reports.

Reporting

Overview

The Reporting module enables you to generate business insights for dashboards and data analytics use cases, including data export.

Reports are organized in workspaces based on their intended usage or target audience. At least one workspace is required to save reports.

Workspace

Overview

Workspaces allow you keep your anlytics organized acoording to use cases/ audience.

Creating Workspaces

Go to-> Reporting.
Click on "Create workspace"
Complete the workspace creation form.
Click "OK" to save.

Editing a workspace

Go to ->Reporting
Locate the desired workspace and click the "Menu" button.
Select "Edit".
Modify workspace attributes as desired.
Click "OK" to save changes.

Deleting a workspace

Go to ->Reporting
Select the desired workspace and click the "Menu" button.
Select "Delete".
Click "OK" to confirm.

Note: Deleting a workspace automatically deletes all the reports in that workspace.

Report

Overview

Reports are metrics derived from your underlying models, by applying one or more data transformation operations. The system supports three default report types:

Single value aggregations: E.g. Total Sales
Visualizations: Customizable charts based on your presentation preference
Data tables: Columnar data.

Creating a report

Go to-> "Reporting"
Click on "Create New report".
Select the model you want to use to create the report. The model is put into the analytics view, allowing you to customize your model accordingly.
Apply one more data transformation operation to generate the final report.

The following section describes the available data transformation operations available and they operate.

Grouping

Overview

Grouping groups underlying data by the selected dimension. It eseesntially executes a "GROUP BY" SQL statement on your data. Your data will be grouped by as many dimensions as selected

How to group

Under the "Dimensions" section, click on one or more dimensions.
The system automatically groups the data by the selected dimension(s).
The grouped data is presented in the data table at the bottom of the screen.

Aggregations:

Overview

Aggregation perform a calculation on one or more numeric columns of your data, by executing a query encapsulated by the defined measure of your model.

How to aggregate

Select the desired aggregations from the aggregation list. The system automatically performs a calculation and presents the aggregated data. In addition to performing the calculation, the systems does the following in real time:

If one one more dimension had been selected, the system automatically performs the aggregation and presents the aggregated data grouped according the selected dimensions.
The system automatically generates a chart. If only dimensions was selected, a bar chart is generated. If more than dimension was selected, a grouped bar chart with the first two selected dimension is generated.
if more than one aggregation is selected, the system automatically generates a series for the second aggregation on a second Y-Axis (right side of the bar chart)
If only an aggregation is selected, the system generates a single aggregate value as a metric.

Filtering

Overview

Filters perform a reduce operation on your data and return a subset of your data based on the filtering criteria.

How to Filter

Select the desired aggregations from the aggregation list. The system automatically performs a calculation and presents the aggregated data. In addition to performing the calculation, the systems does the following in real time:

Hover on any dimension and click on the "Filter" button shown next to the dimension.
Enter your filtering criteria and click "OK".
The system automatically reduces the size of the dataset based on the filter criteria specified. The underlying chart is also updated accordingly.

The following filter/comparison operators are available on the system:

* I propose we present this as a table with the following sctructure: *

Name	Applies to	Return
Equal	Strings, numeric and date columns	Exact match of the specified filter condition
Not Equal	Strings, numeric and date columns	All rows that do not match of the specified filter condition
Greater than	Numeric and date columns	All rows which contain a value greater than the value specified in the condition
Greater than or equal to	Numeric and date columns	All rows which contain a value greater than the value specified in the condition including the specified value
Less than	Numeric and date columns	All rows which contain a value smaller than the value specified in the condition
Less than or equal to	Numeric and date columns	All rows which contain a value less than the value specified in the condition including the specified value
In	String, numeric and date columns	All rows which contain a value from the provided list of match conditions.
Not In	String, numeric and date columns	All rows which do not contain a value from the provided list of match conditions.
Like	String and numeric columns	All rows which contain a value which has the match condition in the value.
Like	String and numeric columns	All rows which do not contain a value which has the match condition in the value.

Modifying the visualization.

Chart Options

Visualizations type: Click on any button to change the visualization type. For example, from a line to a bar chart.
Stacked: Changes from grouped to stacked grouping
Flip: Toggles between "positive" and "negative" values on the X-Axis
Absolute: Disregard any sign information on your data, e.g. -1,000 is converted to 1000
Log: Plots a logarithmic series of the numeric axis/data

Saving a report

Click "Save Report"
Enter a unique and suitable name.
Select save options:
1. Visualization only
2. Table data only
3. Both
Click "OK"

Additional report features:

Optimization function

This feature enables you to track the movement of primarily aggregate metrics.

Goal

This feature allows you to set targets for primarily aggregate metrics. The system will monitor the goal attainment.

Triggers and alerts

This feature allows you to get alerted once predefined threshold conditions for your metrics are met. The following threshold conditions are available by default.

Reaches
Increases
Decreases
Rises above/ Exceeds
Falls below

Dashboards and collections

Overview

A dashboard is a collection of one or more reports. A dashboard is generally the landing page of your analytics application.

A collection is an entity for organizing dashboards according to their use cases. Just like workspaces in reports, they are designed to enhance order in your analytics.

Creating a collections

Go to collections
Click on "New collection"
Fill in the collection creation form.
Complete by clicking on "OK"

Editing a collection

Go to collections
the collection you would like to edit.
Click on "Edit" and modify the collection attributes as intended
Complete by clicking "OK"

Deleting a collection

Go to collections
Select the collection you would like to delete.
Select "Delete" from the "Actions" menu.
Click on "Delete collection" to confirm and complete the delete action.

Note: Deleting a collection will also delete all dashboards in that collection. Creating a dashboard

Creating a dashboard

Go to dashboards
Click on "New dashboard"
Fill in the dashboard creation form and click on "OK"
A blank canvas will be presented for you to populate your dashboard with reports.
Click on the "Add report" button and select the report you would like to add to this dashboard.
Select the desired reports.
You can customize your dashboard by dragging and dropping any report widget anywhere on the dashboard.

Editing a dashboard

Go to-> dashboards
Select the dashboard you would like to edit and click "Edit button"
Modify the dashboard attributes as desired.
Re-arrange the reports if needed.
Click on the "Edit" button again to save.

Deleting a dashboard

Go to-> dashboards
Select the dashboard you would like to delete
Click “Delete".
Confirm delete action by Clicking on "OK".

Defining a default dashboard

Go to-> Dashboards
Select the dashboard you would like to make your default dashboard.
Click on the menu button on the top right side of the dashboard and select "Make default"

Note: With this action, every time you log in or navigate to dashboards, this is the dashboard that will be loaded.

Creating dashboard filters

Go to-> dashboards
Select "dashboards filters" from the menu button
Enter the dashboard filters attributes as presented in the form.
Complete by clicking on "OK".

Integrated Apps

Overview

Integrated apps are prebuilt end to end analytics applications for known data platforms. The provided standardized reports based on the attributes of the source data, and thus do no require you to perform any analytics action on our platform.

Types of integrated apps

They are two basic types of integrated apps:

Push applications:

With this kind of applications, the user is responsible for managing sending data to Athena for analytics, typically programatically. Mininal software development is required.

Pull applications:

These kind of applications typically connect to source data systems and fectch the data required to perform analytics.

They do not require software development. You may however be required to perform certain actions on source platform to enable Athena to connnect to your data. These include obtaining any necessary authentication keys, e.g API keys that Athena will use to connect

Creating a data app

Go to Data -> Apps
Click on "Create App" and enter the app details accordingly.
Select the subscription plan based on your needs.
Select "Trial" if you would like to try the app before purchase (Not available to all apps)
Optionally provide payment details and complete payment actions.
Copy and save the provided API key for use in your code

Deleting a data app

Go to Data -> Apps
Select the app you would like to delete.
Select "Delete" from the menu
Click "Delete" to confirm and delete

Editing a data app

Go to Data -> Apps
Select the app you would like to edit
Select "Edit" from the menu
Update application details accordingly
Complete by clicking on "Update"

Getting a new API key for your app

Go to Data -> Apps
Select the app for which you would like to generate a new API key.
Click on "Get new API key"
Copy and save the new API key for use in your code.

Data ingestion for analytics

Athena uses two scheme to ingest data based on the application type (Pull vs Push).

Pull applications:

For pull applications, Athena automatically connects to the source systems and extracts data to build your analytics. This requires providing the necessary authorization and authentication information, as provided by the source platform to Athena to enable programmatic access.

\Athena's data creation form will guide you on the information required by each data platform provider.

Push applications:

Push applications require you to initiate data ingestion operations from your system. For this, Athena requires you to provide an API key for your data app alongside the data object.

Payload/ Metrics object

The metrics object/payload must strictly confirm to Athena payload specification for each data application type. The payload data specification/requirements are outlined in each application type documentation section.

Sending metrics to Athena

x-api-key: <your-api-key>

Endpoint

POST https://app.athena.io/api/v1/metrics/

Headers:

Content-Type: application/json  
			Accept: application/json  
			x-api-key: <your-api-key>

Response:

A tuple with message and response code. The response text will include the number of rows processed if successful

Request examples:

Node JS

Phyton

PHP

const axios = require('axios');

		async function sendToAthena(data, apiKey) {
		  const endpoint = 'https://app.athena.io/api/v1/metrics/';
		  const headers = {
		    'Content-Type': 'application/json',
		    'Accept': 'application/json',
		    'x-api-key': apiKey
		  };

		  try {
		    const response = await axios.post(endpoint, data, { headers });
		    console.log('Data sent to Athena:', response.data);
		  } catch (error) {
		    console.error('Error sending data to Athena:', error.message);
		  }
		}

		CURL:

		curl -X POST https://app.athena.io/api/v1/metrics/ \
		  -H "Content-Type: application/json" \
		  -H "Accept: application/json" \
		  -H "x-api-key: YOUR_API_KEY" \
		  -d '{"key":"value"}'

Africalstalking

Overview

This integration provides analytis for the various Africastalking communications API. The source data is the object reurned by an Africastalking API as a response to a POST request from your app.

Applies to

SMS, USSD, Airtime, Data, Voice

Payload / Metrics object

The entires response object returned by an Africastalking API endpoint.

How to get started

Follow the steps outlined in Creating a data app and Data ingestion for analytics

How it works

Once integration is successful, Athena will accept requests from your application and automatically update your report and dashboard accordingly.

Subscription & billing

Overview

Bleex charges a periodic recurring rate for any subscription. The minumum subscription period is one month (30 days).

Free tier

Bleex has a standard free tier subscription for up to three user per account. Details of feature availabilitu for this plan can be viewed at http://bleex.io/features.

Trial period

Bleex offers a standard 14-day trial for all user account subscriptions, as well as for selected integrated applications.

Billing cycle

Bleex billing cycle is based on selected billing period, with the billing date being the first day of the billing the selected period.

Billing and payment

At the begining of each billing period, Bleex will automatically charge for the existing subscription. If automatica billing is not enabled, or if we cannot successfully automatically charge the provided paymnent method, a user will be required to initiate payment manually.

Billing notification

If you account is expired, you will be notified via your email address. You will also be notified on the platform.

Activating expired account

Activating expired account automatically charges for and activates all user account subscriptions associated with your subscription.

To activate an expired account, follow the steps outlined below:

Go to Settings - > Account
Click on "Renew Account"
Provide any required information as provided for in the account activation form.
Click OK to complete.

Activating expired integrated apps subscriptions

Go to Settings -> Account - Subscription
Select the application you would like to activate
Click "Activate" on the menu as provided.
Provided any information in the account activation dialogs
Click "OK" to complete

Viewing your subscription

Go to Settings -> Account - Subscriptions.
All you subscriptions with their status will be listed in this page.

Viewing and downloading your invoices

Go to Settings -> Account - Invoice.
All you invoices will be listed here.
If you would like to down any invoice, click on "Download" from the menu. A PDF copy of your invoice will be generated.

Product

Features

Pricing

Integrations

Book a Demo

Company

Blog

About Us

Privacy

Resources

Documentation

Developer Guides

Support

Partners

Become a Partner

Our Affiliate Programme

Nairobi Office

Watermark Business Park, Fountain Court, Suite 1, Karen, Nairobi, Kenya.

info@bleex.io

x.com

Github

Welcome to Bleex knowlege centre

Bleex provides end to end Analytics and data innovation technologies

What is Athena?

Athena is an end to end business intelligence, analytics and data innovation platform

Integrated apps

Athena is an end to end business intelligence, analytics and data innovation platform

Getting started

Athena is an end to end business intelligence, analytics and data innovation platform

Subscription & billing

Athena is an end to end business intelligence, analytics and data innovation platform

Account Management

Athena is an end to end business intelligence, analytics and data innovation platform

API Reference

Athena is an end to end business intelligence, analytics and data innovation platform

Working with data

Athena is an end to end business intelligence, analytics and data innovation platform

Search

Overview

Before you get started

Product Walkthrough

Integrated Apps

Subscription & billing

Overview

What is Athena?

Athena is a versatile business intelligence, analytics, and data innovation platform designed to transform raw data into actionable insights.

What can Athena do?

Athena integrates seamlessly with structured data from relational databases, spreadsheets, CSVs, and web APIs, making it a unified solution for all your analytical needs.

Key Use Cases

Business Intelligence & Analytics

Generate real-time reports and dashboards to track organizational performance—from sales trends to financial health. Athena helps you identify problems, uncover root causes, and act faster with data-driven insights.

Data & Insight Sharing

Centralize your organization’s knowledge and democratize access to insights across teams, ensuring everyone works from the same truth.

Data Innovation

Turn any database into an analytics powerhouse with Athena’s API-first approach. Developers can rapidly build custom, data-driven applications without backend complexity.

Automated Data Pipelines

Streamline workflows for machine learning, ETL, and more. Athena automates repetitive tasks, freeing your team to focus on high-value analysis

Data Quality Management

Surface inconsistencies, duplicates, or errors in your datasets. Athena helps you clean, validate, and maintain high-quality data for accurate reporting.

Before you get started.

Best practise recommendations:

Define the various use cases for your data.

Define the data needs within your organization e.g., which departments or users require certain types of data

Define a system of user organization based on their data needs.

Product Walkthrough

Account Management

Updating your profile

Go to Settings -> Account -> Profile

Select "Personal info" and enter your details accordingly.

Click on Update "Update profile" to complete

Updating your address

Go to Settings -> Account -> Profile

Select "Address" and enter your details accordingly.

Click on "Update profile" to complete

Changing your password

Go to Settings -> Account -> Profile

Select "Password & Security" and enter password details accordingly.

Click on "Confirm password change" to complete

Updating your organization name

Go to Settings -> Account -> Profile

Select "Organisation" and enter your new organization name accordingly.

Click on "Update company name" to complete

Teams/ Groups Management

Overview

A team is an entity used to group one or more users, usually within common data needs together. A user can belong to more than one team or group.

Creating a team

Go to settings -> Account -> Teams Click on "Create new team"

Provide a name and description of the team as provided for in the form.

Optionally assign one ore more users to the team.

Click on "OK" to complete

User Management

Creating users

Go to settings -> Account -> users

Click on "Invite users"

Enter the email addresses of users you want to invite.

Click "OK" to send the invitations.

users will receive a unique "invite code" and a link to activate their account

Editing users

Go to settings -> Account -> users

Select a user from the list of users available.

Click on the menu button of the selected user row and select "Edit."

Generate real-time reports and dashboards to track organizational performance—from sales trends to financial health.

Athena helps you identify problems, uncover root causes, and act faster with data-driven insights.