Observability Framework

• Copyrights and Notices

• 1. What is Connext Observability Framework?
  • 1.1. Telemetry Data
  • 1.2. Distribution of Telemetry Data
  • 1.3. Flexible Storage
  • 1.4. Visualization of Telemetry Data
  • 1.5. Control and Selection of Telemetry Data
  • 1.6. Security
• 2. Components
  • 2.1. Monitoring Library 2.0
  • 2.2. Observability Collector Service
    • 2.2.1. Storage Components
  • 2.3. Observability Dashboards
• 3. Observability Framework Deployments
  • 3.1. Current Release
    • 3.1.1. Docker Compose (Prepackaged)
    • 3.1.2. Docker (Separate Deployment)
  • 3.2. Future releases
    • 3.2.1. Collector Service
• 4. Security
  • 4.1. Secure Communication between Connext Applications and Collector Service
    • 4.1.1. Secure Communication between Connext Applications and Collector Service (Pre-Packaged Deployment)
    • 4.1.2. Secure Communication between Connext Applications and Collector Service (Separate Deployment)
  • 4.2. Secure Communication with Collector Service HTTP Servers
    • 4.2.1. Secure Collector Service HTTP Servers (Pre-Packaged Deployment)
    • 4.2.2. Secure Collector Service HTTP Servers (Separate Deployment)
  • 4.3. Secure Communication with Third-Party Component HTTP Servers
    • 4.3.1. Secure Third-Party Component HTTP Servers (Pre-Packaged Deployment)
    • 4.3.2. Secure Third-Party Component HTTP Servers (Separate Deployment)
  • 4.4. Generating the Observability Framework Security Artifacts
    • 4.4.1. Generating DDS Security Artifacts
    • 4.4.2. Generating HTTPS Security Artifacts
• 5. Installing and Running Observability Framework
  • 5.1. Installing the Host Package
    • 5.1.1. Prerequisites
    • 5.1.2. Install from RTI Launcher
    • 5.1.3. Install from the Command Line
  • 5.2. Configuring, Running, and Removing Observability Framework Components Using Docker Compose
    • 5.2.1. Configuring the Docker Workspace for Observability Framework
    • 5.2.2. Initialize and Run Docker Containers
    • 5.2.3. Verify Docker Containers are Running
    • 5.2.4. Configure Grafana
    • 5.2.5. Stop Docker Containers
    • 5.2.6. Start Existing Docker Containers
    • 5.2.7. Stop and Remove Docker Containers
    • 5.2.8. Removing the Docker Workspace for Observability Framework
• 6. Getting Started Guide
  • 6.1. About the Observability Example
    • 6.1.1. Applications
    • 6.1.2. Data Model
    • 6.1.3. DDS Entity Mapping
    • 6.1.4. Command-Line Parameters
  • 6.2. Before Running the Example
    • 6.2.1. Set Up Environment Variables
    • 6.2.2. Compile the Example
    • 6.2.3. Install Observability Framework
    • 6.2.4. Start the Collection, Storage, and Visualization Docker Containers
  • 6.3. Running the Example
    • 6.3.1. Start the Applications
    • 6.3.2. Changing the Time Range in Dashboards
    • 6.3.3. Simulate Sensor Failure
    • 6.3.4. Simulate Slow Sensor Data Consumption
    • 6.3.5. Simulate Time Synchronization Failures
    • 6.3.6. Change the Application Logging Verbosity
    • 6.3.7. Change the Metric Configuration
    • 6.3.8. Close the Applications
• 7. Telemetry Data
  • 7.1. Introduction
  • 7.2. Resources
    • 7.2.1. Resource Pattern Definitions
  • 7.3. Metrics
    • 7.3.1. Metric Pattern Definitions
    • 7.3.2. Application Metrics
    • 7.3.3. Participant Metrics
    • 7.3.4. Topic Metrics
    • 7.3.5. DataWriter Metrics
    • 7.3.6. DataReader Metrics
    • 7.3.7. Derived Metrics Generated by Prometheus Recording Rules
  • 7.4. Logs
    • 7.4.1. Syslog Levels and Facilities
    • 7.4.2. Activity Context
    • 7.4.3. Log Labels
    • 7.4.4. Collection and Forwarding Verbosity
• 8. Monitoring Library 2.0
  • 8.1. Enabling Monitoring Library 2.0
  • 8.2. Setting the Initial Metrics and Log Configuration
  • 8.3. Setting the Application Name
  • 8.4. Changing the Default Observability Domain ID
  • 8.5. Configuring QoS for Monitoring Library 2.0 Entities
  • 8.6. Setting Collector Service Initial Peers
• 9. Collector Service REST API Reference
  • 9.1. Definitions
  • 9.2. Root endpoint (base URL)
  • 9.3. API Overview
  • 9.4. API Reference
• 10. Observability Dashboards
  • 10.1. System Status Dashboards
    • 10.1.1. System Status Dashboard Common Elements
    • 10.1.2. Alert Home Dashboard
    • 10.1.3. Alert Category Dashboards
  • 10.2. Entity List Dashboards
  • 10.3. Entity Status List Dashboards
  • 10.4. Entity Status Dashboards
  • 10.5. Log Dashboards
    • 10.5.1. Log Dashboard
    • 10.5.2. Entity Log Dashboards
  • 10.6. Control Dashboards
    • 10.6.1. Log Control Dashboard
    • 10.6.2. Metric Control Dashboards
• 11. Troubleshooting Observability Framework
  • 11.1. Docker Container[s] Failed to Start
    • 11.1.1. Check for Port Conflicts
    • 11.1.2. Check that You Have the Correct File Permissions
  • 11.2. No Data in Dashboards
    • 11.2.1. Check that Collector Service has Discovered Your Applications
    • 11.2.2. Check that Prometheus can Access Collector Service
    • 11.2.3. Check that Grafana can Access Prometheus
    • 11.2.4. Check that Grafana can Access Loki
• 12. Glossary
• 13. Release Notes
  • 13.1. Supported Platforms
  • 13.2. Compatibility
  • 13.3. Supported Docker Compose Environments
  • 13.4. What’s New in 7.3.0 LTS
    • 13.4.1. Enhanced control of entities distributed across various Collector Service instances
    • 13.4.2. New REST API in Collector Service to control telemetry data collection and distribution
    • 13.4.3. Support for more flexible Observability Framework deployments
    • 13.4.4. Control which metrics are collected
    • 13.4.5. New Syslog facilities provide expanded log management
    • 13.4.6. New logging category and plugin class labels enable more precise third-party backend queries
    • 13.4.7. Updated dashboards support enhanced logging and dynamic metric control
    • 13.4.8. Name change for some observability metrics
    • 13.4.9. Third-party software upgrades
  • 13.5. What’s Fixed in 7.3.0 LTS
    • 13.5.1. Crashes
    • 13.5.2. Vulnerabilities
  • 13.6. Previous Releases
    • 13.6.1. What’s New in 7.2.0
    • 13.6.2. What’s Fixed in 7.2.0
    • 13.6.3. What’s New in 7.1.0