Saltar a contenido

Librería gRedisConnect

La librería gRedisConnect proporciona una interfaz para establecer y gestionar una conexión a un servidor Redis en Go. También incluye funcionalidad adicional relacionada con la salud y el monitoreo del servidor Redis.

Instalación

Para instalar la librería gRedisConnect, puedes ejecutar el siguiente comando:

go get github.com/architecture-it/gRedisConnect

Uso básico

Para utilizar la librería gRedisConnect en tu proyecto, primero debes importarla:

import "github.com/architecture-it/gRedisConnect"

A continuación, puedes crear una instancia de la conexión Redis utilizando la función NewRepository:

repo := gRedisConnect.NewRepository(addr, pass, db)

Donde addr es la dirección del servidor Redis, pass es la contraseña (puede ser una cadena vacía si no se requiere autenticación) y db es el número de base de datos a seleccionar.

Una vez creada la instancia de la conexión Redis, puedes utilizar el método GetClient para obtener el cliente Redis:

client := repo.GetClient(context.Background())

El cliente Redis devuelto es de tipo *redis.Client y se puede utilizar para realizar operaciones en el servidor Redis.

Configuración de la salud

La librería gRedisConnect incluye integración con la biblioteca gHealth-go para monitorear el estado de la conexión Redis. Puedes pasar una instancia de health.Health opcional al crear la conexión Redis para habilitar el monitoreo de salud:

h := health.New() // Crea una instancia de health.Health

repo := gRedisConnect.NewRepository(addr, pass, db, h)

Esto registrará automáticamente una comprobación de salud para el servidor Redis utilizando la biblioteca gHealth-go. Puedes personalizar la configuración de la comprobación de salud modificando los valores en el código fuente.

Dependencias

La librería gRedisConnect tiene las siguientes dependencias:

  • github.com/architecture-it/go-platform/log: Una biblioteca de registro utilizada para registrar mensajes relacionados con la conexión Redis.
  • github.com/go-redis/redis: Una biblioteca para interactuar con servidores Redis en Go.
  • go.elastic.co/apm/module/apmgoredis/v2: Una biblioteca para habilitar el monitoreo de aplicaciones APM (Application Performance Monitoring) en la conexión Redis.

Asegúrate de incluir estas dependencias en tu archivo de configuración de módulos o en tu archivo de definición de dependencias.