O11ySources

Welcome to the O11ySources User Guide! This guide is your essential resource for mastering Observability Sources (referred to as O11ySources hereafter) within the vuSmartMaps™ platform. With O11ySources, you can effortlessly set up data sources, storyboards, and alert rules, streamlining your data pipeline and ETL process.

Prerequisites

Ensure vuSmartMaps is installed before configuring O11ySources and that you have admin access to configure O11ySources.

Getting Started with O11ySources

In today’s tech-driven world, O11ySources serves as your gateway to understanding your system’s performance, providing actionable insights into various critical aspects. O11ySources allows you to monitor a wide array of essential data sources, such as databases, network devices, applications, web servers, and more.

By collecting and analyzing data from these sources, O11ySources empowers you to optimize the performance of your systems. For example, it helps you track the response times of your applications, ensuring they run smoothly and efficiently. It also enables you to monitor server resource utilization, identifying potential bottlenecks that may impact your system’s responsiveness.

Whether you’re evaluating the health of your servers, tracking network performance, analyzing application behavior, or diving into the performance of your database queries, O11ySources provides you with the specific tools and insights needed to ensure the efficiency and effectiveness of the systems.

Data Onboarding with O11ySources

O11ySources, such as ‘Linux Monitor’ and ‘Apache’, seamlessly integrate with your existing setup. They consolidate data from multiple sources, creating a unified data flow that empowers your analysis and reporting systems. This integration streamlines data onboarding from target systems to enhance business observability with vuSmartMaps.

Data Flow Journey

Explore how data flows within the system by examining the key stages of the data journey:

1. Data Ingestion: Agents like Healtheat, Logbeat, and Telegraf collect data from various sources using mechanisms like push or pull.
2. Data Processing: The data undergoes transformations and enrichments, gaining context and domain knowledge. This phase of ContextStreams involves components like I/O streams and data pipelines, ensuring efficient data processing.
3. Data Storage: The processed data finds its home in stores like Elasticsearch (ES) or HyperScale. These data stores form the basis for user functionalities such as alerts and dashboards, providing actionable insights.
4. Data Consumption: The final stage is where the processed data is utilized through visualizations, dashboards, alerts, and reports. This is where users interact with the data, deriving meaningful insights, making informed decisions, and taking necessary actions based on real-time data analysis and historical trends.

To fully utilize the O11ySource framework, your journey starts with configuring data sources by enabling O11ySources. This guide will be your trusted companion, guiding you through these essential steps. As you delve deeper, you’ll gain a profound understanding of the vital components that keep your data flowing smoothly within your system.

Working with O11ySources

Accessing and managing O11ySources in vuSmartMaps is a simple process. Here’s how you can do it:

1. vuSmartMaps O11ySources can be accessed by navigating from the left navigation menu (Data Ingestion > O11ySources).
   
   
   
2. You will be directed to the O11ySources page, displaying a complete list of available O11ySources.
   
   
   
3. Use the checkbox (Enabled/ Disabled) to filter the list, showing only enabled/ disabled O11ySources.
   
   
   
4. By default, all O11ySources are disabled initially.
5. Click on the O11ySource name you want to configure, such as “Apache.”
6. Click the Enable button for the desired O11ySource. For example, we enable Apache as below:
   
   
   

💡Note: When O11ySources is enabled, it shows the Alert Rules and Storyboards linked to the displayed sources. If it is disabled, it hides them. Ensure that you’ve followed all the instructions in the Get Started section to enable data onboarding for seamless operations.

Linux Monitoring O11ySource – An Example

To understand the workflow more properly, as an example, we discuss the steps to configure the source for Linux Monitor in detail.

Importing O11ySources

The “Import O11ySources” feature allows users to upload new O11ySources or upgrade existing ones via a tar.gz file. This feature streamlines integrating new O11ySources or enhancing current ones, ensuring your observability framework remains up-to-date.

1. Access the Import Feature: Navigate to the O11ySources landing page, and click the Import button.
2. Upload the O11ySource File:
   • A dialog box will appear prompting you to upload a tar.gz file.
   • Select the tar.gz file of the O11ySource you wish to import (maximum file size: 0.29 MB).
   • The Upload button will be enabled once a valid file is selected.
3. Import Process:
   • Click the Upload button to initiate the import.
   • If the uploaded file is a new O11ySource, it will be added in a disabled state.
   • If the file corresponds to an existing O11ySource, the current state (enabled/disabled) will be retained, and the upgrades will be applied.

💡Note: 

1. New O11ySource: Upon import, new O11ySources will be added in a disabled state. You need to enable them manually after ensuring all configurations are correctly set.
2. Existing O11ySource: If importing an upgrade for an existing O11ySource, it will retain its current state (enabled or disabled).
3. Sources Configuration Changes: If the upgrade involves changes in the Source configuration, the import may fail due to potential backward incompatibilities. In such cases, contact the VuNet support team to confirm whether the upgrade can be performed using the import button. If not, the upgrade will be done through a product release update.