observability

package
v0.0.0-...-6fa98e6 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 14, 2025 License: UPL-1.0 Imports: 6 Imported by: 0

Documentation

Index

Constants

View Source
const (
	UnknownValue = "UNKNOWN"
	DefaultValue = "DEFAULT"
)
View Source
const (
	StatusObservabilityPending v4.StatusEnum = "PENDING"
	StatusObservabilityError   v4.StatusEnum = "ERROR"
	StatusObservabilityReady   v4.StatusEnum = "READY"
)

Observability Status

View Source
const (
	LogReconcile               = "ObservabilityExporterLogger"
	LogExportersDeploy         = "ObservabilityExporterDeploymentLogger"
	LogExportersSVC            = "ObservabilityExporterServiceLogger"
	LogExportersServiceMonitor = "ObservabilityExporterServiceMonitorLogger"
)

Log Names

View Source
const (
	DefaultDbUserKey                 = "username"
	DefaultDBPasswordKey             = "password"
	DefaultDBConnectionStringKey     = "connection"
	DefaultConfigVolumeString        = "config-volume"
	DefaultLogFilename               = "alert.log"
	DefaultLogVolumeString           = "log-volume"
	DefaultWalletVolumeString        = "creds"
	DefaultOCIPrivateKeyVolumeString = "ocikey"
	DefaultOCIConfigFingerprintKey   = "fingerprint"
	DefaultOCIConfigRegionKey        = "region"
	DefaultOCIConfigTenancyKey       = "tenancy"
	DefaultOCIConfigUserKey          = "user"

	DefaultExporterImage                 = "container-registry.oracle.com/database/observability-exporter:1.5.2"
	DefaultServicePort                   = 9161
	DefaultServiceTargetPort             = 9161
	DefaultAppPort                       = 8080
	DefaultPrometheusPort                = "metrics"
	DefaultServiceType                   = "ClusterIP"
	DefaultReplicaCount                  = 1
	DefaultExporterConfigMountRootPath   = "/oracle/observability"
	DefaultOracleHome                    = "/lib/oracle/21/client64/lib"
	DefaultOracleTNSAdmin                = DefaultOracleHome + "/network/admin"
	DefaultExporterConfigmapFilename     = "config.toml"
	DefaultVaultPrivateKeyRootPath       = "/oracle/config"
	DefaultPrivateKeyFileKey             = "privatekey"
	DefaultPrivateKeyFileName            = "private.pem"
	DefaultVaultPrivateKeyAbsolutePath   = DefaultVaultPrivateKeyRootPath + "/" + DefaultPrivateKeyFileName
	DefaultExporterConfigmapAbsolutePath = DefaultExporterConfigMountRootPath + "/" + DefaultExporterConfigmapFilename
)

Defaults

View Source
const (
	DefaultSelectorLabelKey = "app"
	DefaultReleaseLabelKey  = "release"
)

labeling

View Source
const (
	EnvVarOracleHome                   = "ORACLE_HOME"
	EnvVarDataSourceUser               = "DB_USERNAME"
	EnvVarDataSourcePassword           = "DB_PASSWORD"
	EnvVarDataSourceConnectString      = "DB_CONNECT_STRING"
	EnvVarDataSourceLogDestination     = "LOG_DESTINATION"
	EnvVarDataSourcePwdVaultSecretName = "VAULT_SECRET_NAME"
	EnvVarDataSourcePwdVaultId         = "VAULT_ID"
	EnvVarCustomConfigmap              = "CUSTOM_METRICS"
	EnvVarTNSAdmin                     = "TNS_ADMIN"
	EnvVarVaultTenancyOCID             = "vault_tenancy_ocid"
	EnvVarVaultUserOCID                = "vault_user_ocid"
	EnvVarVaultFingerprint             = "vault_fingerprint"
	EnvVarVaultPrivateKeyPath          = "vault_private_key_path"
	EnvVarVaultRegion                  = "vault_region"
)

Known environment variables

View Source
const (
	IsCRAvailable                 = "ExporterReady"
	IsExporterDeploymentReady     = "DeploymentReady"
	IsExporterServiceReady        = "ServiceReady"
	IsExporterServiceMonitorReady = "ServiceMonitorReady"
)

Positive ConditionTypes

View Source
const (
	ReasonInitStart                      = "InitializationStarted"
	ReasonReadyValidated                 = "ReadinessValidated"
	ReasonValidationInProgress           = "ReadinessValidationInProgress"
	ReasonReadyFailed                    = "ReadinessValidationFailed"
	ReasonDeploymentSpecValidationFailed = "SpecValidationFailed"

	ReasonDeploymentSuccessful = "ResourceDeployed"
	ReasonResourceUpdated      = "ResourceUpdated"
	ReasonResourceUpdateFailed = "ResourceUpdateFailed"
	ReasonDeploymentFailed     = "ResourceDeploymentFailed"
	ReasonDeploymentPending    = "ResourceDeploymentInProgress"

	ReasonGeneralResourceGenerationFailed            = "ResourceGenerationFailed"
	ReasonGeneralResourceCreated                     = "ResourceCreated"
	ReasonGeneralResourceCreationFailed              = "ResourceCreationFailed"
	ReasonGeneralResourceValidationCompleted         = "ResourceDeployed"
	ReasonGeneralResourceValidationFailureDueToError = "ResourceCouldNotBeValidated"
)

Reason

View Source
const (
	ErrorCRRetrieve                           = "an error occurred with retrieving the cr"
	ErrorStatusUpdate                         = "an error occurred with updating the cr status"
	ErrorSpecValidationFailedDueToAnError     = "an error occurred with validating the exporter deployment spec"
	ErrorDeploymentPodsFailure                = "an error occurred with deploying exporter deployment pods"
	ErrorResourceCreationFailure              = "an error occurred with creating databaseobserver resource"
	ErrorResourceRetrievalFailureDueToAnError = "an error occurred with retrieving databaseobserver resource"
	LogErrorWithResourceUpdate                = "an error occurred with updating resource"
)

Log Errors

View Source
const (
	LogCRStart                   = "Started DatabaseObserver instance reconciliation"
	LogCREnd                     = "Ended DatabaseObserver instance reconciliation, resource must have been deleted."
	LogResourceCreated           = "Created DatabaseObserver resource successfully"
	LogResourceUpdated           = "Updated DatabaseObserver resource successfully"
	LogResourceFound             = "Validated DatabaseObserver resource readiness"
	LogSuccessWithResourceUpdate = "Updated DatabaseObserver resource successfully"
)

Log Infos

View Source
const (
	MessageCRInitializationStarted = "Started initialization of custom resource"
	MessageCRValidated             = "Completed validation of custom resource readiness successfully"
	MessageCRValidationFailed      = "Failed to validate readiness of custom resource due to an error"
	MessageCRValidationWaiting     = "Waiting for other resources to be ready to fully validate readiness"

	MessageResourceCreated                   = "Completed creation of resource successfully"
	MessageResourceCreationFailed            = "Failed to create resource due to an error"
	MessageResourceReadinessValidated        = "Completed validation of resource readiness"
	MessageResourceReadinessValidationFailed = "Failed to validate resource due to an error retrieving resource"
	MessageResourceGenerationFailed          = "Failed to generate resource due to an error"

	MessageExporterDeploymentSpecValidationFailed = "Failed to validate export deployment spec due to an error with the spec"
	MessageExporterResourceUpdateFailed           = "Failed to update exporter resource due to an error"
	MessageExporterResourceUpdated                = "Updated exporter resource successfully"
	MessageExporterDeploymentValidationFailed     = "Failed to validate exporter deployment due to an error retrieving resource"
	MessageExporterDeploymentSuccessful           = "Completed validation of exporter deployment readiness"
	MessageExporterDeploymentFailed               = "Failed to deploy exporter deployment due to PodFailure"
	MessageExporterDeploymentListingFailed        = "Failed to list exporter deployment pods"
	MessageExporterDeploymentPending              = "Waiting for exporter deployment pods to be ready"
)

Messages

View Source
const (
	EventReasonFailedCRRetrieval  = "ExporterRetrievalFailed"
	EventMessageFailedCRRetrieval = "Encountered error retrieving databaseObserver instance"

	EventReasonSpecError                                 = "DeploymentSpecValidationFailed"
	EventMessageSpecErrorDBPasswordSecretMissing         = "Spec validation failed due to required dbPassword secret not found"
	EventMessageSpecErrorDBConnectionStringSecretMissing = "Spec validation failed due to required dbConnectionString secret not found"
	EventMessageSpecErrorDBPUserSecretMissing            = "Spec validation failed due to dbUser secret not found"
	EventMessageSpecErrorConfigmapMissing                = "Spec validation failed due to custom config configmap not found"
	EventMessageSpecErrorDBWalletSecretMissing           = "Spec validation failed due to provided dbWallet secret not found"

	EventReasonUpdateSucceeded = "ExporterDeploymentUpdated"
)

Event Recorder Outputs

View Source
const (
	DefaultExporterContainerName = "observability-exporter"
)

default resource

Variables

This section is empty.

Functions

func AddEnv

func AddEnv(env []corev1.EnvVar, existing map[string]string, name string, v string) []corev1.EnvVar

AddEnv is a helper method that appends an Env Var value

func AddEnvFrom

func AddEnvFrom(env []corev1.EnvVar, existing map[string]string, name string, v *corev1.EnvVarSource) []corev1.EnvVar

AddEnvFrom is a helper method that appends an Env Var value source

func AddNamespaceSelector

func AddNamespaceSelector(a *api.DatabaseObserver, spec *monitorv1.ServiceMonitorSpec)

func AddSidecarContainers

func AddSidecarContainers(a *api.DatabaseObserver, listing *[]corev1.Container)

func AddSidecarVolumes

func AddSidecarVolumes(a *api.DatabaseObserver, listing *[]corev1.Volume)

func GetEndpoints

func GetEndpoints(a *api.DatabaseObserver) []monitorv1.Endpoint

GetEndpoints function

func GetExporterArgs

func GetExporterArgs(a *api.DatabaseObserver) []string

GetExporterArgs retrieves args

func GetExporterCommands

func GetExporterCommands(a *api.DatabaseObserver) []string

GetExporterCommands retrieves commands

func GetExporterConfig

func GetExporterConfig(a *api.DatabaseObserver) string

GetExporterConfig function retrieves config name for status

func GetExporterDeploymentSecurityContext

func GetExporterDeploymentSecurityContext(a *api.DatabaseObserver) *corev1.SecurityContext

GetExporterDeploymentSecurityContext retrieves security context for container

func GetExporterDeploymentVolumeMounts

func GetExporterDeploymentVolumeMounts(a *api.DatabaseObserver) []corev1.VolumeMount

GetExporterDeploymentVolumeMounts function retrieves volume mounts from a or provides default

func GetExporterDeploymentVolumes

func GetExporterDeploymentVolumes(a *api.DatabaseObserver) []corev1.Volume

GetExporterDeploymentVolumes function retrieves volumes from a or provides default

func GetExporterEnvs

func GetExporterEnvs(a *api.DatabaseObserver) []corev1.EnvVar

GetExporterEnvs function retrieves env from a or provides default

func GetExporterImage

func GetExporterImage(a *api.DatabaseObserver) string

GetExporterImage function retrieves image from a or provides default

func GetExporterPodSecurityContext

func GetExporterPodSecurityContext(a *api.DatabaseObserver) *corev1.PodSecurityContext

GetExporterPodSecurityContext retrieves security context for pods

func GetExporterReplicas

func GetExporterReplicas(a *api.DatabaseObserver) int32

GetExporterReplicas function retrieves replicaCount from a or provides default

func GetExporterServicePort

func GetExporterServicePort(a *api.DatabaseObserver) []corev1.ServicePort

GetExporterServicePort function retrieves exporter service port from a or provides default

func GetExporterVersion

func GetExporterVersion(a *api.DatabaseObserver) string

GetExporterVersion retrieves version of exporter used

func GetLabels

func GetLabels(a *api.DatabaseObserver, customResourceLabels map[string]string) map[string]string

GetLabels retrieves labels from the spec

func GetLogName

func GetLogName(a *api.DatabaseObserver) string

func GetLogVolumeSource

func GetLogVolumeSource(a *api.DatabaseObserver) corev1.VolumeSource

GetLogVolumeSource function retrieves the source to help GetExporterDeploymentVolumes

func GetSelectorLabel

func GetSelectorLabel(a *api.DatabaseObserver) map[string]string

GetSelectorLabel adds selector label

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL