import { Long, unknownFieldsSymbol } from "../../../../../runtime/protos/index.js"; import type { Duration, MessageDescriptor, MessageFns, EnumInstance, EnumClass } from "../../../../../runtime/protos/index.js"; import { customJson } from "../../../../../runtime/util/logging.js"; import { ChannelCredentials, Client, ClientUnaryCall, ClientOptions, CallOptions, Metadata, ServiceError as GrpcServiceError, handleUnaryCall, UntypedServiceImplementation } from "@grpc/grpc-js"; import type { SDKInterface } from "../../../../../sdk.js"; import { Request as SDKRequestClass, type RetryOptions } from "../../../../../runtime/request.js"; /** * Type of the agent in the system. * */ export type AgentType = EnumInstance<"UNRECOGNIZED" | "AGENT_UNDEFINED" | "O11Y_AGENT">; /** Defines the static values of {@link AgentType}. */ export interface AgentTypeValueMembers { /** * Default undefined state. * */ readonly AGENT_UNDEFINED: EnumInstance<"UNRECOGNIZED" | "AGENT_UNDEFINED" | "O11Y_AGENT">; /** * Observability agent type. * */ readonly O11Y_AGENT: EnumInstance<"UNRECOGNIZED" | "AGENT_UNDEFINED" | "O11Y_AGENT">; } /** Defines the runtime API for {@link AgentType}. */ export type AgentTypeClass = EnumClass<"UNRECOGNIZED" | "AGENT_UNDEFINED" | "O11Y_AGENT"> & AgentTypeValueMembers; /** Converts and creates {@link AgentType} values. */ export declare const AgentType: AgentTypeClass; /** * Current operational state of the agent. * */ export type AgentState = EnumInstance<"UNRECOGNIZED" | "STATE_UNDEFINED" | "STATE_HEALTHY" | "STATE_ERROR">; /** Defines the static values of {@link AgentState}. */ export interface AgentStateValueMembers { /** * Default undefined state. * */ readonly STATE_UNDEFINED: EnumInstance<"UNRECOGNIZED" | "STATE_UNDEFINED" | "STATE_HEALTHY" | "STATE_ERROR">; /** * Agent is functioning normally. * */ readonly STATE_HEALTHY: EnumInstance<"UNRECOGNIZED" | "STATE_UNDEFINED" | "STATE_HEALTHY" | "STATE_ERROR">; /** * Agent is in error state. * */ readonly STATE_ERROR: EnumInstance<"UNRECOGNIZED" | "STATE_UNDEFINED" | "STATE_HEALTHY" | "STATE_ERROR">; } /** Defines the runtime API for {@link AgentState}. */ export type AgentStateClass = EnumClass<"UNRECOGNIZED" | "STATE_UNDEFINED" | "STATE_HEALTHY" | "STATE_ERROR"> & AgentStateValueMembers; /** Converts and creates {@link AgentState} values. */ export declare const AgentState: AgentStateClass; /** * Action to be taken by the agent based on version check. * */ export type Action = EnumInstance<"UNRECOGNIZED" | "ACTION_UNDEFINED" | "NOP" | "UPDATE" | "RESTART">; /** Defines the static values of {@link Action}. */ export interface ActionValueMembers { /** * Default undefined action. * */ readonly ACTION_UNDEFINED: EnumInstance<"UNRECOGNIZED" | "ACTION_UNDEFINED" | "NOP" | "UPDATE" | "RESTART">; /** * No operation needed. * */ readonly NOP: EnumInstance<"UNRECOGNIZED" | "ACTION_UNDEFINED" | "NOP" | "UPDATE" | "RESTART">; /** * Update to new version required. * */ readonly UPDATE: EnumInstance<"UNRECOGNIZED" | "ACTION_UNDEFINED" | "NOP" | "UPDATE" | "RESTART">; /** * Agent restart required. * */ readonly RESTART: EnumInstance<"UNRECOGNIZED" | "ACTION_UNDEFINED" | "NOP" | "UPDATE" | "RESTART">; } /** Defines the runtime API for {@link Action}. */ export type ActionClass = EnumClass<"UNRECOGNIZED" | "ACTION_UNDEFINED" | "NOP" | "UPDATE" | "RESTART"> & ActionValueMembers; /** Converts and creates {@link Action} values. */ export declare const Action: ActionClass; /** * Request message for GetVersion RPC containing agent status and system information. * */ export interface GetVersionRequest { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.GetVersionRequest"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Type of the agent. Must be O11Y_AGENT (1). * */ type: AgentType; /** * Current version of the agent software. * */ agentVersion: string; /** * Version of the updater component. * */ updaterVersion: string; /** * Parent identifier for the VM * */ parentId: string; /** * Unique identifier for the instance where agent is running. * */ instanceId: string; /** * Detailed information about the operating system. * */ osInfo?: OSInfo | undefined; /** * Current operational state of the agent. * */ agentState: AgentState; /** * Time duration since the agent started. * */ agentUptime?: Duration | undefined; /** * Total system uptime. * */ systemUptime?: Duration | undefined; /** * Time duration since the updater component started. * */ updaterUptime?: Duration | undefined; /** * Status messages from the agent describing its current state. * */ agentStateMessages: string[]; /** * Description of the last update failure, if any. * */ lastUpdateError: string; /** * Managed Kubernetes cluster identifier, if applicable. * */ mk8sClusterId: string; /** * Health status of individual agent modules. * */ modulesHealth?: ModulesHealth | undefined; /** * Status of cloud initialization process. * */ cloudInitStatus: string; /** * Indicates if a fallback method was used to determine instance_id. * */ instanceIdUsedFallback: boolean; /** * Recent agent log entries for diagnostic purposes. * */ lastAgentLogs: string; /** * Model of the GPU used in the system. * */ gpuModel: string; /** * Number of GPUs available in the system. * */ gpuNumber: number; /** * Version of the DCGM (Data Center GPU Manager) used. * */ dcgmVersion: string; /** * Health check logs information for monitoring disk usage. * */ healthcheckLogs?: HealthCheckLogs | undefined; /** * Largest config_version this agent has already accepted; 0 if none. * */ lastSeenConfigVersion: Long; } /** Encodes, decodes, converts, and creates {@link GetVersionRequest} messages. */ export declare const GetVersionRequest: MessageFns; /** * Health status information for all agent modules. * */ export interface ModulesHealth { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.ModulesHealth"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Health status of the process module. * */ process?: ModuleHealth | undefined; /** * Health status of the GPU pipeline module. * */ gpuPipeline?: ModuleHealth | undefined; /** * Health status of the CPU pipeline module. * */ cpuPipeline?: ModuleHealth | undefined; /** * Health status of the Cilium pipeline module. * */ ciliumPipeline?: ModuleHealth | undefined; /** * Health status of the VM applications pipeline module. * */ vmappsPipeline?: ModuleHealth | undefined; /** * Health status of the common service logs pipeline module. * */ commonServiceLogsPipeline?: ModuleHealth | undefined; /** * Health status of the vm service logs pipeline module. * */ vmServiceLogsPipeline?: ModuleHealth | undefined; /** * Health status of the compute GPU logs pipeline module. * */ computeGpuLogsPipeline?: ModuleHealth | undefined; /** * Health status of the journald pipeline module. * */ journaldPipeline?: ModuleHealth | undefined; /** * Health status of the NCCL metrics pipeline module. * */ ncclMetricsPipeline?: ModuleHealth | undefined; } /** Encodes, decodes, converts, and creates {@link ModulesHealth} messages. */ export declare const ModulesHealth: MessageFns; /** * Health check logs information for monitoring disk usage. * */ export interface HealthCheckLogs { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.HealthCheckLogs"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Size of the healthcheck directory in bytes. * */ directorySizeBytes: Long; /** * Total size of the healthcheck mountpoint in bytes. * */ mountpointTotalBytes: Long; } /** Encodes, decodes, converts, and creates {@link HealthCheckLogs} messages. */ export declare const HealthCheckLogs: MessageFns; /** * Health status information for an individual module. * */ export interface ModuleHealth { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.ModuleHealth"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Current operational state of the module. * */ state: AgentState; /** * Status messages describing the module's state. * */ messages: string[]; /** * Current parameters of the module. * */ parameters: Parameter[]; } /** Encodes, decodes, converts, and creates {@link ModuleHealth} messages. */ export declare const ModuleHealth: MessageFns; /** * Key-value parameter for module configuration. * */ export interface Parameter { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.Parameter"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Name of the parameter. * */ name: string; /** * Value of the parameter. * */ value: string; } /** Encodes, decodes, converts, and creates {@link Parameter} messages. */ export declare const Parameter: MessageFns; /** * Operating system information for the instance. * */ export interface OSInfo { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.OSInfo"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Operating system name and version. * Example: "Ubuntu 22.04.4 LTS" * */ name: string; /** * Detailed system information from uname command. * * Example: * ``` * Linux computeimage-abcdef 6.5.0-44-generic #44~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Tue Jun 18 14:36:16 UTC 2 x86_64 x86_64 x86_64 GNU/Linux * ``` * */ uname: string; /** * System architecture. * */ architecture: string; } /** Encodes, decodes, converts, and creates {@link OSInfo} messages. */ export declare const OSInfo: MessageFns; /** * Response message for GetVersion RPC containing required action for the agent. * */ export interface GetVersionResponse { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.GetVersionResponse"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Required action for the agent to take. * */ action: Action; /** * Feature flags for the agent. Keys are UPPER_CASE flag names, values are flag values (typically "true"/"false"). * When feature_flags_unavailable is true the agent must ignore this field and * keep its current flag set unchanged. * */ featureFlags: { [key: string]: string; }; /** * True when the server could not load feature-flag state. The agent must * keep its current flag set instead of treating an empty feature_flags map * as "clear all". The default value of false means feature_flags is * authoritative — including legitimately empty. * */ featureFlagsUnavailable: boolean; /** * Version of the rollout state this response was built from. Agent echoes * it back as last_seen_config_version on the next request. * */ configVersion: Long; /** * Parameters specific to the required action. * */ response?: { $case: "nop"; nop: NopActionParams; } | { $case: "update"; update: UpdateActionParams; } | { $case: "restart"; restart: RestartActionParams; } | undefined; } /** Encodes, decodes, converts, and creates {@link GetVersionResponse} messages. */ export declare const GetVersionResponse: MessageFns; /** * Parameters when no operation is required. * */ export interface NopActionParams { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.NopActionParams"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; } /** Encodes, decodes, converts, and creates {@link NopActionParams} messages. */ export declare const NopActionParams: MessageFns; /** * Parameters for agent update action. * */ export interface UpdateActionParams { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.UpdateActionParams"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; /** * Target version for the update. * */ version: string; /** * URL of the repository containing the update. * */ repoUrl: string; } /** Encodes, decodes, converts, and creates {@link UpdateActionParams} messages. */ export declare const UpdateActionParams: MessageFns; /** * Parameters for agent restart action. * */ export interface RestartActionParams { /** Contains the fully qualified protobuf type name. */ $type: "nebius.logging.agentmanager.v1.RestartActionParams"; /** Preserves protobuf fields that this SDK version does not recognize. */ [unknownFieldsSymbol]?: Uint8Array | undefined; /** Returns a safe value for JSON logs. */ [customJson]?: () => unknown; } /** Encodes, decodes, converts, and creates {@link RestartActionParams} messages. */ export declare const RestartActionParams: MessageFns; /** * Defines the gRPC methods for the `nebius.logging.agentmanager.v1.VersionService` service. */ export type VersionServiceServiceDescription = typeof VersionServiceServiceDescription; /** * Describes the gRPC methods for the `nebius.logging.agentmanager.v1.VersionService` service. */ export declare const VersionServiceServiceDescription: { readonly getVersion: { readonly path: "/nebius.logging.agentmanager.v1.VersionService/GetVersion"; readonly requestStream: false; readonly responseStream: false; readonly requestSerialize: (value: GetVersionRequest) => Buffer; readonly requestDescriptor: () => MessageDescriptor | undefined; readonly sendResetMask: false; readonly requestDeserialize: (value: Buffer) => GetVersionRequest; readonly responseSerialize: (value: GetVersionResponse) => Buffer; readonly responseDeserialize: (value: Buffer) => GetVersionResponse; }; }; /** * Handles server calls for the `nebius.logging.agentmanager.v1.VersionService` service. */ export interface VersionServiceServer extends UntypedServiceImplementation { /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion: handleUnaryCall; } /** * Defines the low-level gRPC client for the `nebius.logging.agentmanager.v1.VersionService` service. */ export interface VersionServiceBaseClient extends Client { /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion(request: GetVersionRequest, metadata: Metadata, options: Partial, callback: (error: GrpcServiceError | null, response: GetVersionResponse) => void): ClientUnaryCall; } /** * Creates low-level gRPC clients for the `nebius.logging.agentmanager.v1.VersionService` service. */ export declare const VersionServiceBaseClient: { /** Creates a low-level client for the service address. */ new (address: string, credentials: ChannelCredentials, options?: Partial): VersionServiceBaseClient; /** Contains the gRPC service description. */ service: typeof VersionServiceServiceDescription; /** Contains the fully qualified protobuf service name. */ serviceName: string; }; /** * VersionService provides functionality for managing nebius-observability-agent versions and health status * in the Nebius observability system. * */ export interface VersionService { /** Contains the fully qualified protobuf service name. */ $type: "nebius.logging.agentmanager.v1.VersionService"; /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion(request: GetVersionRequest): SDKRequestClass; /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion(request: GetVersionRequest, metadata: Metadata): SDKRequestClass; /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion(request: GetVersionRequest, metadata: Metadata, options: Partial & RetryOptions): SDKRequestClass; } /** * Calls the `nebius.logging.agentmanager.v1.VersionService` service through the Nebius SDK. */ export declare class VersionService implements VersionService { private sdk; $type: "nebius.logging.agentmanager.v1.VersionService"; private addr; private spec; private apiServiceName; /** Creates a client that uses the SDK service address. */ constructor(sdk: SDKInterface); /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion(request: GetVersionRequest): SDKRequestClass; /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion(request: GetVersionRequest, metadata: Metadata): SDKRequestClass; /** * GetVersion retrieves version information and receives instructions for agent updates * or maintenance based on the current state and health of the agent. * */ getVersion(request: GetVersionRequest, metadata: Metadata, options: Partial & RetryOptions): SDKRequestClass; } //# sourceMappingURL=index.d.ts.map