Faros Community Edition (CE) is an innovative open-source engineering operations platform designed to aggregate operational data sources for a unified view throughout the software development life cycle. In this guide, we will walk you through setting up and utilizing this powerful tool, ensuring you get the most from your engineering metrics.

Features of Faros Community Edition

• Rich Data Schema: Connects multiple operational data points (50+ entities) from tasks to deployments.
• Easy Data Import: Seamlessly import data from Task Management, Version Control, Incident Management, and CI/CD systems.
• Flexible GraphQL API: Automate exploration with your data in its canonical representation.
• Preconfigured Dashboards: Analyze well-known engineering metrics like DORA and SPACE.
• Extensibility and Shareability: Create and share custom metrics and dashboards.
• Container-based Deployment: Deploy on any platform, including your laptop or cloud, with no external dependencies.

Installation Process

To set up Faros CE and start gathering analytics from Git and Jira within 10 minutes, follow these steps:

• Ensure you have Docker Desktop and git installed on your machine.
• Open your terminal and run the following installation script:

bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/faros-ai/faros-community-edition/main/install.sh) --source github_readme

• For further details about the installation script, refer to the Faros Essentials.

Step-by-step Instructions

Once you have successfully installed Faros CE, follow the Quickstart Guide to connect your engineering systems, explore metrics, and gain insights while getting familiar with tools such as Airbyte, Metabase, Hasura, and n8n.

Understanding the Architecture

Faros CE is built using entirely open-source components, each serving a specific purpose:

• Airbyte: Facilitates data integration from various sources.
• Hasura: Offers real-time access to data through GraphQL APIs.
• Metabase: A BI tool for generating metrics, charts, and dashboards.
• dbt: Handles data transformations for actionable metrics.
• n8n: Automates workflows based on your data.
• PostgreSQL: The relational database for storing canonical data.
• Docker: Runs all the services seamlessly.
• Flyway: Manages your database schema evolution.
• Faros Events CLI: Reports events to the Faros platform from your CI/CD pipeline.

Troubleshooting Tips

If you encounter issues during setup or usage:
1. Ensure that all prerequisites for installation, particularly Docker Desktop, are correctly set up. 2. If you have problems with connections, check your firewall settings to ensure that they are not blocking necessary ports. 3. Review the logs for any error messages that could provide clues about the underlying issue. 4. Visit the official documentation for troubleshooting tips or reach out on Slack for live help. 5. If you run into bugs or have suggestions, consider contributing to the GitHub Issues page.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

Final Thoughts

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

Use Faros CE to harness the power of your data, streamline your engineering processes, and drive valuable insights for your projects!