Documentación de Oracle Cloud Infrastructure

Consulta de métricas de correo electrónico

Puede acceder a las métricas de correo electrónico y analizarlas mediante la consola web, la API o la interfaz de línea de comandos (CLI).

El núcleo de este proceso es la creación de una consulta de métricas. La forma más sencilla de crear estas consultas es con el Explorador de métricas en la consola web de OCI. El explorador de métricas le permite seleccionar filtros, construir la sintaxis de consulta y utilizar esa sintaxis en la API o la CLI para buscar métricas.

Las consultas de métricas utilizan el lenguaje de consulta de supervisión de Oracle (MQL) para especificar:

  • Métricas que recuperar
  • Intervalo para agregación de datos
  • Dimensiones para limitar los datos
  • Criterios de agrupación
  • Función de estadística que se aplica a los datos de cada intervalo
  • Predicado para filtrar resultados por umbral o ausencia de datos

Para obtener más información, consulte la Referencia de métricas de Email Delivery, que muestra todas las métricas de Email Delivery disponibles y sus dimensiones.

Creación de una consulta en un explorador de métricas

  1. En la lista de compartimentos, seleccione el compartimento o seleccione root para todos los arrendamientos.
  2. En las opciones de espacio de nombres de métrica, seleccione oci_emaildelivery para las métricas de Email Delivery.
  3. Seleccione un nombre de métrica, como aceptado, reenviado, devuelto, reclamaciones, abierto u otra métrica disponible. Solo se muestran las métricas con datos.
  4. Seleccione un intervalo de tiempo (el valor por defecto es 1 minuto). Puede seleccionar hora completa, día completo o definir un intervalo personalizado en minutos u horas.
  5. Elija una estadística (el valor por defecto es media; otras opciones incluyen percentiles como Pxx).
  6. Seleccione una o más dimensiones:
    • Seleccione un nombre de dimensión, como resourceDomain (dominio de envío de correo electrónico) o resourceId (emisor aprobado).
    • En función de su elección, seleccione un valor de dimensión (dominio o remitente) de la lista mostrada.
  7. Seleccione Actualizar gráfico. La consulta MQL aparece en el panel izquierdo. El gráfico anterior muestra los datos resultantes.
  8. Para crear una alarma basada en la consulta, seleccione Crear alarma. Puede utilizar los servicios de notificación o transmisión para enviar alertas.

Ejemplo de consultas de métricas

Datos necesarios Consulta (rango de tiempo independiente de la consulta)
Todos los correos electrónicos enviados por el servicio, por minuto EmailsAccepted[1m].count()
Todos los correos electrónicos enviados por el servicio, por hora EmailsAccepted[1h].count()
Correos electrónicos transmitidos (es decir, transmitidos correctamente al proveedor de correo electrónico del destinatario) por todos los remitentes de sales.mydomain.com, por día EmailsRelayed[1d]{resourceDomain = "mydomain.com"}.count()
Recuento de devoluciones permanentes por día EmailsHardBounced[1d].count()
Recuento del número diario de correos electrónicos enviados por el remitente marketing@mydomain.com que se suprimen (bloquean) porque el destinatario está en la lista de supresión. EmailsSuppressed[1d]{resourceId = "<sender-ocid>"}.count()

Nota: La dimensión resourceId necesita el OCID del remitente aprobado, no la dirección de correo electrónico. Puede obtener el OCID del remitente en la página Enviadores aprobados.
Correos electrónicos abiertos para remitentes de mydomain.com, por día EmailsOpened[1d].count()
Nota

Las métricas no se pueden agrupar por una dimensión de cabecera personalizada. Si necesita esta capacidad, utilice la integración de Logging. Para obtener instrucciones, consulte Email Log Searching.

Consulta de métricas de Email Delivery mediante la API

Para acceder a las métricas de entrega de correo electrónico mediante la API, utilice el método SummarizeMetricsData del servicio Monitoring. Al igual que el explorador de métricas, este método necesita un OCID de compartimento y un objeto SummarizeMetricsDataDetails que contenga el rango de fechas, el espacio de nombres (utilice oci_emaildelivery para las métricas de Email Delivery) y una consulta MQL.

Nota

Al filtrar por dimensiones de métrica, como resourceDomain o resourceId, MQL necesita comillas dobles. Si utiliza Python o un lenguaje similar, incluya la cadena MQL entre comillas simples en el código para que pueda mantener las comillas dobles necesarias alrededor de los valores dentro de MQL. Consulte los ejemplos de código a continuación.

En la siguiente tabla, se muestran ejemplos de listas de métricas de python y consultas de datos. Sustituya <compartment_ocid> por el OCID del compartimento o el OCID del arrendamiento al realizar consultas en el compartimento raíz.

Datos necesarios Ejemplo de código (Python)

Lista de métricas disponibles para el espacio de nombres "oci_emaildelivery", ordenadas por nombre en orden ascendente

 
import oci

config = oci.config.from_file()
monitoring_client = oci.monitoring.MonitoringClient(config)

list_metrics_response = monitoring_client.list_metrics( compartment_id="ocid1.compartment.oc1..aaaaaaaawqhwudf3pag5gohpzslu7tn4rl2d32bufkgmfzzr4wq7aznylpeq",
list_metrics_details=oci.monitoring.models.ListMetricsDetails(
namespace="oci_emaildelivery",
sort_by="NAME",
sort_order="ASC"
)
)

Las comillas dobles rodean todos los valores de parámetros porque no hay ninguna consulta que contenga comillas dobles.

Recuento de correos electrónicos aceptados por minuto en una ventana de una hora (de 12:00 a 13:00 el 2 de marzo de 2023) en todos los remitentes y dominios de envío

 
import oci

config = oci.config.from_file()
monitoring_client = oci.monitoring.MonitoringClient(config)

summarize_metrics_data_response = monitoring_client.summarize_metrics_data(
compartment_id="ocid1.compartment.oc1..aaaaaaaawqhwudf3pag5gohpzslu7tn4rl2d32bufkgmfzzr4wq7aznylpeq",
summarize_metrics_data_details=oci.monitoring.models.SummarizeMetricsDataDetails(
namespace="oci_emaildelivery",
query="EmailsAccepted[1m].count()",
start_time=datetime.strptime("2023-03-02T12:00:00.000Z", "%Y-%m-%dT%H:%M:%S.%fZ"),
end_time=datetime.strptime("2023-03-02T13:00:00.000Z", "%Y-%m-%dT%H:%M:%S.%fZ")
)
)

Las comillas dobles rodean todos los valores de parámetros porque no hay ninguna consulta que contenga comillas dobles.

Recuento de aperturas por día durante un período de 14 días para todos los correos electrónicos enviados por un remitente aprobado concreto

 
import oci

config = oci.config.from_file()
monitoring_client = oci.monitoring.MonitoringClient(config)

summarize_metrics_data_response = monitoring_client.summarize_metrics_data(
compartment_id='ocid1.compartment.oc1..aaaaaaaawqhwudf3pag5gohpzslu7tn4rl2d32bufkgmfzzr4wq7aznylpeq',
summarize_metrics_data_details=oci.monitoring.models.SummarizeMetricsDataDetails(
namespace='oci_emaildelivery',
query='EmailsOpened[1d]{resourceId = "ocid1.emailsender.oc1.uk-london-1.amaaaaaaooyoulaa6f5dubcaci7stvzf6vdli6wpzw4mtapdeymtgqokkljq"}.count()',
start_time=datetime.strptime('2023-03-01T00:00:00.000Z', '%Y-%m-%dT%H:%M:%S.%fZ'),
end_time=datetime.strptime('2023-03-15T00:00:00.000Z', '%Y-%m-%dT%H:%M:%S.%fZ')
)
)

Comillas simples utilizadas alrededor de argumentos en cadenas Python para que pueda utilizar comillas dobles según lo requiera la consulta MQL para valores resourceDomain.

Recuento de aperturas por día durante un período de 14 días para todos los correos electrónicos enviados por un remitente aprobado concreto

 
import oci

config = oci.config.from_file()
monitoring_client = oci.monitoring.MonitoringClient(config)

summarize_metrics_data_response = monitoring_client.summarize_metrics_data(
compartment_id='ocid1.compartment.oc1..aaaaaaaawqhwudf3pag5gohpzslu7tn4rl2d32bufkgmfzzr4wq7aznylpeq',
summarize_metrics_data_details=oci.monitoring.models.SummarizeMetricsDataDetails(
namespace='oci_emaildelivery',
query='EmailsOpened[1d]{resourceId = "ocid1.emailsender.oc1.uk-london-1.amaaaaaaooyoulaa6f5dubcaci7stvzf6vdli6wpzw4mtapdeymtgqokkljq"}.count()',
start_time=datetime.strptime('2023-03-01T00:00:00.000Z', '%Y-%m-%dT%H:%M:%S.%fZ'),
end_time=datetime.strptime('2023-03-15T00:00:00.000Z', '%Y-%m-%dT%H:%M:%S.%fZ')
)
)

Comillas simples utilizadas alrededor de argumentos en cadenas Python para que pueda utilizar comillas dobles según lo requiera la consulta MQL para valores resourceDomain.