> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Charts

> Analizar datos de series temporales, crear cálculos, establecer umbrales, monitorear alertas, evaluar la calidad de los datos y visualizar actividades.

<a id="create-a-chart" />

## Crear un gráfico

<Steps>
  <Step title="Navegar a Charts">
    Navegar a **Flows** > **Charts**.
  </Step>

  <Step title="Crear un nuevo gráfico">
    Seleccionar **+ Nuevo gráfico** para comenzar un nuevo gráfico. Para construir sobre un gráfico existente, seleccionar ⋮ a la derecha del gráfico > **Duplicar**.

    <Frame>
      <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/charts_toolbars_v1.svg" alt="Barra de herramientas de gráficos" />
    </Frame>

    ➀ **Barra de herramientas** — pasa el cursor sobre cada herramienta para ver una descripción. Utilice el **Control deslizante** para ver o comparar valores de series cronológicas.

    ➁ **Abrir en...** — descargar, duplicar, eliminar o **abrir** el gráfico en **Canvas**.

    ➂ **Añadir datos** — añadir una **serie temporal**, o importar o crear un **cálculo**.

    ➃ **Agentes** — abrir un **agente de IA** para trabajar con el gráfico.

    ➄ **Barra lateral** — configurar **alertas**, **monitoreo**, **umbrales**, o **perfilado de datos**. Añadir **eventos** y **actividades**.
  </Step>
</Steps>

<a id="use-an-agent-to-find-and-analyze-data" />

### Usar un agente para encontrar y analizar datos.

<Frame>
  <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/charts_agent_v4.svg" alt="Atlas en Charts" width="60%" />
</Frame>

➀ **Nueva sesión** — iniciar una nueva conversación con un agente.

➁ **Seleccionar ubicaciones** — ver tu ubicación actual. Seleccionar ubicaciones para elegir qué datos puede acceder el agente.

➂ **Seleccionar agente** — seleccionar el agente con el que deseas iniciar una conversación.

<Info>
  Para interactuar con un agente, necesitas estas [capacidades](/cdf/access/guides/capabilities#atlas-ai).

  Aprender más sobre [Atlas AI](/cdf/atlas_ai/concepts/index).
</Info>

<a id="add-a-time-series" />

### Añadir una serie cronológica

Para añadir una serie cronológica a su gráfico:

<Steps>
  <Step title="Abrir Agregar series temporales">
    Seleccionar **Añadir datos** > **Añadir serie temporal**.
  </Step>

  <Step title="Seleccionar y agregar series temporales">
    Encuentra y selecciona la serie temporal > **Añadir**.
    Para cada serie cronológica y cálculo, explore las diferentes formas de establecer unidades y ajustar la visualización de datos. Por ejemplo, intente ajustar el grosor y el color de la línea del diagrama. Haz clic en <Icon icon="info" /> para más detalles.
  </Step>
</Steps>

<a id="add-a-calculation" />

### Añadir un cálculo

Para añadir un cálculo:

<Steps>
  <Step title="Crear un cálculo">
    Selecciona **Añadir datos** > **Crear cálculo**.
  </Step>

  <Step title="Agregar fuentes de entrada">
    Selecciona **Añadir nodo** o haz clic derecho en el panel debajo del gráfico para añadir fuentes de entrada.

    <Frame>
      <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/calculation.png" alt=" Cálculos de gráficos" />
    </Frame>
  </Step>

  <Step title="Agregar constantes o funciones">
    Haz clic derecho en el panel para añadir **constantes** o **funciones** al cálculo. Selecciona <Icon icon="info" /> para ver los detalles de la función o pasa el cursor sobre los parámetros para más información.
  </Step>

  <Step title="Configurar salida">
    Conecta los cálculos en orden e incluye el nodo final **salida** para mostrar el resultado en el gráfico.

    <Info>
      Utiliza un cálculo como entrada para otro para ver la salida de cada paso.
    </Info>
  </Step>
</Steps>

<a id="schedule-a-calculation" />

### Programar cálculo

Programe un cálculo y guarde el resultado como serie cronológica. También puede [monitorear](#monitor-time-series) su cálculo.

<Steps>
  <Step title="Guardar y programar">
    [Añadir un cálculo](#add-a-calculation) y selecciona **Guardar y Programar**.
  </Step>

  <Step title="Especificar credenciales">
    Especifica las credenciales de inicio de sesión para el programa y haz clic en **Siguiente**. Si no conoces las credenciales, contacta a tu administrador de CDF.
  </Step>

  <Step title="Configurar ajustes de programación">
    Asigna un nombre al programa y especifica los ajustes necesarios.
  </Step>

  <Step title="Iniciar la programación">
    Selecciona **Iniciar programa**.
  </Step>
</Steps>

<a id="trend-data" />

### Datos de tendencias

Para apilar, superponer y comparar tendencias de series cronológicas, utilice <kbd>clic + arrastrar</kbd> o <kbd>pasar el cursor + desplazarse</kbd> para ajustar y mover cada eje del diagrama.

Utilice el **Control deslizante** en la barra de herramientas para ver o comparar valores de series cronológicas en un momento específico.

<a id="view-and-assess-data-quality" />

### Ver y evaluar la calidad de los datos

Una línea del gráfico **aparece sombreada** si la calidad de los datos de una serie cronológica es **incierta** y presenta una **brecha** si es **mala**.

Utilice el **perfilado de datos** para evaluar la calidad de una serie cronológica y si se ajusta a su propósito. El perfilado de datos utiliza la [Biblioteca de Ciencia de Datos Industrial (InDSL)](https://indsl.docs.cognite.com/) para definir brechas si los deltas de tiempo se desvían más de 1.5 veces el rango intercuartílico.

<Steps>
  <Step title="Abrir Perfilado de datos">
    En el gráfico, selecciona **Perfilado de datos**. Selecciona la serie temporal que deseas evaluar en la lista desplegable **Fuente**.
  </Step>

  <Step title="Ver métricas de calidad">
    Cambia entre ver un diagrama de caja y un histograma de deltas de tiempo o densidad.
  </Step>
</Steps>

<a id="set-thresholds-for-historical-data" />

### Establecer umbrales para datos históricos

Para establecer umbrales para datos históricos:

<Steps>
  <Step title="Abrir Umbrales">
    En la parte superior derecha del gráfico, selecciona el ícono de **Umbral**.
  </Step>

  <Step title="Configurar valores de umbral">
    En el panel, establece los valores de umbral para las series temporales y cálculos.
  </Step>
</Steps>

<a id="add-events" />

### Añadir eventos

Puede añadir eventos, como un apagado defectuoso, para ayudar a analizar las series cronológicas.

Para agregar eventos a un gráfico:

<Steps>
  <Step title="Abrir Eventos">
    Selecciona **Eventos** desde la barra lateral.
  </Step>

  <Step title="Configurar filtros de eventos">
    Agrega o selecciona un filtro para especificar los eventos a agregar.
  </Step>
</Steps>

<a id="add-activities" />

### Agrega actividades

Las actividades en Cognite Data Fusion (CDF) representan tareas, eventos u operaciones que ocurren durante un período de tiempo en su entorno industrial. Proporcionan una forma estructurada de rastrear trabajo, mantenimiento, inspecciones y otras actividades basadas en el tiempo, conectando el trabajo planificado y ejecutado con sus activos físicos y datos operativos.

Activa **Actividad** para visualizar y contextualizar los datos de series temporales con estos eventos operacionales en su gráfico. Las actividades aparecen como barras verticales en el gráfico, proporcionando una referencia visual para ayudarle a correlacionar el comportamiento de las series temporales con actividades operacionales relevantes como trabajo de mantenimiento, inspecciones o eventos de producción.

#### Requisitos previos

Antes de agregar actividades a un gráfico, asegúrese de que:

* Los datos relevantes están modelados como [actividades o actividades extendidas en su proyecto CDF](/cdf/dm/dm_reference/dm_core_data_model#cogniteactivity).
* Tiene derechos de acceso `lectura` de series temporales para ver Gráficos y los datos relevantes.

Para agregar actividades a un gráfico:

<Steps>
  <Step title="Añadir serie cronológica">
    Seleccione **+ Agregar datos** > **Agregar series temporales**. Busque y seleccione la serie temporal que desea visualizar.
  </Step>

  <Step title="Seleccionar actividades">
    En el menú desplegable Categoría, seleccione **Actividad**, y luego seleccione las actividades que desea visualizar. Una vez seleccionadas, la capa de **Actividad** se activará automáticamente.

    <Note>
      El filtro de **Activo** se aplica automáticamente según las series temporales a las que pertenecen los activos en el gráfico. Puede limpiar o agregar filtros según sus preferencias.
    </Note>
  </Step>
</Steps>

Las actividades aparecen como barras verticales azules en la capa de **Actividad**. Estas barras le ayudan a correlacionar visualmente las series temporales con actividades relevantes en el marco de tiempo seleccionado. Las barras tienen diferentes niveles de transparencia para distinguir las actividades superpuestas.

Para trabajar con actividades:

<Steps>
  <Step title="Ver detalles de la actividad">
    Haz clic en una barra de actividad para ver detalles como los horarios de inicio y fin, una descripción y el activo al que está vinculada la actividad. Haz clic en **Ver detalles** para ver toda la información sobre la actividad.
  </Step>

  <Step title="Fijar una actividad">
    Haz clic en el ícono de pin <Icon icon="pin" /> para mantener la actividad resaltada mientras la comparas con otras actividades.
  </Step>
</Steps>

<a id="monitor-time-series" />

## Supervisar series cronológicas

Los trabajos de monitoreo de series temporales envían [correos electrónicos por cualquier incumplimiento de los umbrales](/cdf/configure/charts_monitoring) que establezcas. Si hay varios incumplimientos dentro del *período de duración mínima*, solo recibirás un correo electrónico por el período.

Recomendamos que establezcas una duración mínima de 5 minutos para limitar la cantidad de alertas por correo electrónico que recibes. La frecuencia mínima esperada de puntos de datos es de 1 minuto. Si los puntos de datos tienen una frecuencia más baja, las alertas pueden no activarse como se espera.

<a id="create-monitoring-jobs" />

### Crear trabajos de monitoreo

<Steps>
  <Step title="Monitoreo Abierto">
    Selecciona **Monitoreo** > **Crear** desde la barra lateral.
  </Step>

  <Step title="Nombrar el trabajo">
    Asigna un **nombre** al trabajo de monitoreo.
  </Step>

  <Step title="Seleccionar una fuente">
    Selecciona la serie temporal o el cálculo que deseas monitorear en el menú desplegable **Fuente**.
  </Step>

  <Step title="Establecer umbral y duración">
    Especifica el **umbral** y la **duración mínima** para la alerta.
  </Step>

  <Step title="Especificar carpeta de almacenamiento">
    Especifica la carpeta para almacenar las alertas.
  </Step>

  <Step title="Seleccionar destinatarios">
    Selecciona a los usuarios que recibirán las alertas por correo electrónico.
  </Step>

  <Step title="Opcional. Configurar opciones avanzadas">
    Abre **Opciones avanzadas** y especifica las credenciales de inicio de sesión para el trabajo de monitoreo.
  </Step>

  <Step title="Iniciar supervisión">
    Selecciona **Iniciar monitoreo**.
  </Step>
</Steps>

<a id="subscribe-to-alerts" />

### Suscribirse a las alertas

Para **suscribirse** a una alerta:

<Steps>
  <Step title="Monitoreo Abierto">
    Selecciona **Monitoreo** desde la barra lateral.
  </Step>

  <Step title="Suscribirse a la alerta">
    Encuentra la alerta a la que deseas suscribirte y selecciona <Icon icon="bell" />.
  </Step>
</Steps>

<a id="resolve-alerts" />

### Resolver alertas

Para **resolver** una alerta que ha investigado:

<Steps>
  <Step title="Abrir historial de alertas">
    Seleccionar la alerta > **Historial**.
  </Step>

  <Step title="Marcar como resuelto">
    Seleccionar **Activo** > **Marcar como resuelto**.
  </Step>
</Steps>

<a id="data-aggregation" />

## Agregación de datos

Si un gráfico contiene más de 100,000 puntos de datos, Charts resume los puntos de datos para facilitar la visualización de los datos. Los datos agregados aparecen sombreados y muestran los valores mínimo y máximo del rango de datos agregados. Amplíe para ver puntos de datos individuales.