2 Telemetry Streaming Architecture and Components

This chapter discusses the high-level architecture of Telemetry Streaming and its various components.

Topics:

• Telemetry Streaming Architecture
  
• Telemetry Streaming Components Overview
  

2.1 Telemetry Streaming Architecture

The following diagram shows a high-level architecture of Telemetry Streaming, providing an overview of the interconnect among its different components, with emphasis on the database components.

Figure 2-1 Telemetry Streaming Architecture

The PL/SQL packages and tables, and the REST API handlers are parts of the Telemetry Streaming implementation. Oracle REST Data Services (ORDS) is used to enable REST services for external clients.

The Telemetry Streaming components enable you to build robust metric streaming applications. Telemetry Streaming supports the push model of time series data ingestion, where clients ingest (push) their time series data into Telemetry Streaming. You can have SQL clients use the PL/SQL packages to ingest data into Telemetry Streaming. You can also have REST clients ingest metric data into Telemetry Streaming using REST APIs through ORDS. You can have a REST client query Telemetry Streaming using PromQL or SQL. You can also use PromQL and SQL queries to query metrics on SQL clients.

You can find more details about these components in the following sections of this document.

2.2 Telemetry Streaming Components Overview

ORDS

Oracle REST Data Services (ORDS) needs to be installed with REST API handlers to enable external clients to use REST APIs and ingest data into or query data from Telemetry Streaming. The REST APIs are made available by initializing them using the DBMS_TELEMETRY_ADMIN PL/SQL package. All the REST APIs used through ORDS are authorized using the OAuth2 client credentials protocol.

Note:

ORDS is not a part of Telemetry Streaming installation and needs to be installed separately.

Telemetry Streaming Database

Telemetry Streaming Database is a specialized database optimized for time series data. It is the central component that enables the storage, retrieval, and management of data. Ingest components, such as ORDS, push data into Telemetry Streaming for efficient storage and query.

Running the Telemetry Streaming SQL installation script enables an Oracle AI Database for the Telemetry Streaming service. Telemetry Streaming hosts the PL/SQL packages and tables that provide the Telemetry Streaming infrastructure.