Getting started on the FireTail platform

Created:
September 7, 2023
Updated:
November 3, 2023

This getting started guide is designed to help you start using the FireTail SaaS platform. View comprehensive documentation and explore all the functionalities of the FireTail platform by selecting from the documentation categories.

The steps detailed below are the suggested order of your initial setup on the FireTail platform, however, steps 1-4 should be completed first to enable a smooth setup of the rest of the platform.

Set up steps

  1. Set up an account
  2. Create an organization
  3. Create applications
  4. API discovery
  5. Notification integrations
  6. Alerting
  7. Logging integrations
  8. Upload specifications

Step 1. Set up an account

To get started, you need to set up an account to sign in to the FireTail platform. To do this:

  1. Go to firetail.app.
  2. Click Get Started.
  3. Enter an email address and password or click Continue with Google to sign in with your Google account.

Follow the on-screen instructions to complete the sign-up process. To learn more, go to How do I set up an account.

Step 2. Create an organization

When you have an account set up the next thing you need to do is create an organization.

Adding an organization enables you to Add members and set up the Applications, APIs, Integrations and Alerts within that organization. You can create multiple organizations if needed. Each organization exists separately on the platform, nothing is shared between them. For instance, when a member is added it is only added to that organization, if that member needs access to a different organization they need to be added to that. When you first sign up to the FireTail platform, you are prompted to create an organization. You can also create organizations using the dropdown menu in the FireTail platform.

When you create an organization you must select what subscription you want to avail of, this includes a free 7 day trial of the business subscription.

Learn more:

Step 3. Create applications

With an organization created, you can now populate the platform with API information. The first step to this is to create an application, this step is necessary, as when you discover APIs or create APIs these are added to an application.

Learn more about applications here.

Step 4. API discovery

Set up an integration to get full visibility of your APIs. You can create an integration with AWS, Azure and GitHub.

Learn more:

Step 5. Create a notification integration

Creating a notification integration enables you to receive notifications when an alert is triggered. You should set up the integration before creating the alert as you need to select which notification service you want to receive the alert to.

Learn more:

Step 6. Alerts

The alerting functionality of FireTail's platform enables you to set defined filters, conditions, and thresholds that when reached will trigger an alert. When creating the alert you select the notification method, then if the threshold and conditions are met you will receive a notification to your selected notification.  

Learn how to Create an alert here.

Step 7. Logging integrations

Create an integration with AWS logging. Your logs will be ingested into the platform. You can view logs in the log table of the dashboard.

Learn more:

Step 8. Specifications

Specifications can be used to group information for an API. Creating a specification on the platform allows you to view the inventory data. You can upload a specification as a JSON or YAML file. Specifications are uploaded to an API.

Learn more about specifications here.