Skip to content

Commit 2c627b2

Browse files
Translation Pipeline PR (#33239)
* Translated file updates * Translated file updates --------- Co-authored-by: webops-guacbot[bot] <214537265+webops-guacbot[bot]@users.noreply.github.com>
1 parent 165f119 commit 2c627b2

File tree

5 files changed

+577
-0
lines changed

5 files changed

+577
-0
lines changed
Lines changed: 196 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,196 @@
1+
---
2+
description: Busca y analiza al instante logs de archivos de larga duración sin tener
3+
que volver a indexarlos.
4+
further_reading:
5+
- link: /logs/explorer/
6+
tag: Documentación
7+
text: Explorar logs en Datadog
8+
- link: /logs/log_configuration/archives/
9+
tag: Documentación
10+
text: Configurar archivos de logs
11+
- link: /logs/indexes/
12+
tag: Documentación
13+
text: Gestionar la retención y la indexación de logs
14+
title: Archive Search
15+
---
16+
17+
{{< callout url="https://www.datadoghq.com/product-preview/flex-frozen-archive-search/" btn_hidden="false" >}}
18+
Archive Search está en vista previa. Solicita acceso para buscar logs archivados en tiempo real. Sin reindexación ni retrasos. Accede instantáneamente a años de datos cuando los necesites.
19+
{{< /callout >}}
20+
21+
## Información general
22+
23+
Archive Search te permite consultar logs directamente desde archivos de almacenamiento de objetos a largo plazo, sin indexarlos previamente. Utiliza Archive Search para **acceder de forma inmediata a logs archivados**, para investigaciones, auditorías o resolución de problemas más allá de su periodo de retención de indexación.
24+
25+
Archive Search se diferencia de Rehydration en que transmite los resultados en tiempo real a medida que se escanean los datos, en lugar de ejecutarse como un trabajo en lote en segundo plano. Es más rentable, ya que solo se cobra por el escaneo en sí y los primeros 100 000 logs se conservan temporalmente sin coste alguno, y más rápido.
26+
27+
Al iniciar una búsqueda:
28+
29+
* Los logs se envían a una página específica de resultados.
30+
* Se retienen hasta **100 000 logs** durante **24 horas**.
31+
* Opcionalmente, puedes **indexar los resultados** antes o después de la búsqueda para conservarlos durante más tiempo y que estén disponibles en todo Datadog.
32+
33+
Esta función es compatible con logs archivados a través de:
34+
35+
- [archivos de Datadog Log Management][1]
36+
- [archivos de Observability Pipelines][2]
37+
38+
### Casos de uso típicos
39+
40+
Archive Search es ideal cuando se necesita consultar logs que están almacenados en un archivo externo.
41+
Los casos de uso más comunes son:
42+
43+
- **Investigaciones de incidentes:** recupera logs vinculados a un `transaction_id`, `user_id` o `session_id` que quedan fuera de tu retención de indexación.<br>
44+
*Ejemplo: consulta logs de hace tres semanas utilizando un `user_id` específico, incluso si tu retención indexada es de solo 15 días.*
45+
46+
- **Análisis de seguridad:** examina logs archivados para investigar intentos de inicio de sesión u otra actividad por IP o usuario.<br>
47+
*Ejemplo: recupera todos los intentos de inicio de sesión desde una dirección IP específica en los últimos 12 meses.
48+
49+
- **Apoyo al cumplimiento de normativas y auditorías:** accede a logs archivados de clientes o facturación para auditorías sin tener que reindexar permanentemente grandes volúmenes de datos.<br>
50+
*Ejemplo: consulta de logs relacionados con facturas (`customer_id:12345`, `service:billing`) de los últimos 18 meses para una auditoría fiscal.*
51+
52+
## Requisitos previos
53+
54+
Antes de utilizar Archive Search:
55+
56+
1. Configura un archivo externo (Amazon S3, Azure Storage o Google Cloud Storage). Consulta [Log Archives][3].
57+
1. Asegúrate de que Datadog tiene permiso para leer del archivo, consulta [Permisos específicos de la nube](#cloud-specific-permissions).
58+
* **Amazon S3:** delegación de roles de IAM
59+
* **Azure Storage:** Azure AD con el rol *Storage Blob Data Contributor*
60+
* **Google Cloud Storage:** cuenta de servicio con el rol *Storage Object Viewer*
61+
62+
### Permisos
63+
64+
Los resultados de Archive Search son visibles para todos los usuarios de tu organización que tengan acceso a la función Archive Search. Sin embargo, las **consultas de restricción**, como los filtros de seguridad de logs y las restricciones de datos configuradas en Datadog, se siguen aplicando en la página de resultados y se aplican a todos los usuarios. Esto significa que cada usuario solo puede ver logs que están autorizados a ver sobre la base de los permisos y filtros de toda la organización.
65+
66+
Para obtener más información sobre los controles de acceso y la seguridad de logs, consulta [Cómo configurar RBAC para logs][6].
67+
68+
## Iniciar una búsqueda
69+
70+
1. Ve a [**Logs > Archive Search > New Search**][4] (Logs > Archive Search > Nueva búsqueda).
71+
2. Selecciona un archivo y un intervalo de tiempo.
72+
3. Introduce una consulta, como `user_id:abc123`.
73+
4. (Opcional) Cambia el nombre de la búsqueda.
74+
5. (Opcional) Habilita la indexación antes de iniciar la búsqueda.
75+
6. Haz clic en **Search** (Buscar).
76+
77+
Los logs aparecen en tiempo real en la página de resultados. Una barra de progreso muestra el estado del escaneo, y puedes detener la búsqueda en cualquier momento.
78+
79+
## Vista previa de la consulta
80+
81+
Al crear o configurar una búsqueda, Datadog descarga una pequeña muestra (hasta 1000 logs) del archivo y el intervalo de tiempo seleccionados.
82+
Utiliza esta vista previa para verificar la sintaxis de la consulta, inspeccionar la estructura del log y ajustar los filtros.
83+
84+
**Nota**: Es posible que la muestra de vista previa no incluya logs que coincidan con tu consulta. Es solo para validación y exploración.
85+
86+
## Ver y conservar los resultados
87+
88+
Por defecto, solo se cobra por el escaneo. Los primeros 100 000 logs se almacenan temporalmente (24 horas) sin coste alguno y son accesibles directamente en las páginas de resultados de Archive Search, donde puedes hacer clic en cualquier log para ver todos tus detalles y contexto. Transcurridas 24 horas, los resultados caducan automáticamente.
89+
90+
Para conservar más datos o acceder a logs en otros productos de Datadog, elige una de las siguientes opciones:
91+
92+
- **Índice antes del lanzamiento**:
93+
Conserva más de 100 000 logs, establece un periodo de retención personalizado (por ejemplo, 7, 15 o 30 días) y accede a los resultados en toda la plataforma de forma inmediata.
94+
- **Índice tras la finalización**:
95+
Durante el intervalo de 24 horas, puedes indexar los resultados para ampliar su retención y hacer que estén disponibles en el Log Explorer, dashboards y notebooks.
96+
97+
## Analizar los resultados
98+
99+
Tras iniciar una búsqueda, los logs aparecen en **Archive Search Results** (Resultados de Archive Search). Desde la página, puedes utilizar filtros para limitar los resultados y abrir detalles específicos de logs para investigar los problemas.
100+
101+
### Limitaciones
102+
103+
Aunque la búsqueda de archivos proporciona acceso a los logs archivados, sus capacidades analíticas son limitadas en comparación con los logs indexados:
104+
105+
- **Sin agregaciones ni análisis**: no se pueden ejecutar agregaciones, crear visualizaciones ni realizar análisis avanzados directamente en los resultados de Archive Search.
106+
- **Solo resultados de la página**: los resultados de Archive Search solo están disponibles en los resultados específicos de la página y no pueden consultarse desde otras partes de la plataforma de Datadog (como dashboards, notebooks o el Log Explorer).
107+
108+
Para habilitar el análisis completo y la visibilidad en toda la plataforma, debes indexar los resultados de la búsqueda (ya sea antes de iniciar la búsqueda o después de completarla dentro del intervalo de 24 horas). Una vez indexados, los logs estarán disponibles en todos los productos de Datadog con todas las funciones de agregación, visualización y análisis.
109+
110+
111+
## Gestionar las búsquedas
112+
113+
<!-- {{< img src="path/to/your/image-name-here.png" alt="La descripción de tu imagen" style="width:100%;" >}} -->
114+
115+
Desde la [**vista de lista de Archive Search**][5], puedes:
116+
117+
- **Detener** una búsqueda en curso: conserva logs ya recuperados.
118+
- **Duplicar** una búsqueda: abre el formulario de creación de la búsqueda de archivo con los mismos parámetros para una repetición eficaz.
119+
120+
## Rendimiento de búsqueda y volumen de escaneo
121+
122+
Archive Search escanea los archivos de log archivados dentro del intervalo de tiempo seleccionado. El **volumen de escaneo** es el tamaño total de los archivos leídos durante la consulta. Los volúmenes de escaneo grandes pueden aumentar el tiempo y el coste de la búsqueda.
123+
124+
Para mejorar el rendimiento de las consultas y reducir el volumen de escaneo:
125+
- Reduce el intervalo de tiempo y utiliza filtros selectivos.
126+
- Los administradores con permiso **Logs Write Archives** pueden establecer límites máximos de log y duraciones de retención disponibles.
127+
128+
## Permisos específicos de la nube
129+
130+
Datadog requiere el permiso de lectura de tus archivos para buscar contenido en ellos. Este permiso puede cambiarse en cualquier momento.
131+
132+
{{< tabs >}}
133+
{{% tab "Amazon S3" %}}
134+
135+
Para rehidratar eventos de log desde tus archivos, Datadog utiliza el rol de IAM en tu cuenta de AWS que configuraste para [tu integración de AWS][1]. Si aún no has creado ese rol, [sigue estos pasos para hacerlo][2]. Para permitir que ese rol rehidrate eventos de log desde tus archivos, añade la siguiente declaración de permiso a sus políticas de IAM. Asegúrate de editar los nombres de los buckets y, si lo deseas, especifica las rutas que contienen tus archivos de log.
136+
137+
```json
138+
{
139+
"Version": "2012-10-17",
140+
"Statement": [
141+
{
142+
"Sid": "DatadogUploadAndRehydrateLogArchives",
143+
"Effect": "Allow",
144+
"Action": ["s3:PutObject", "s3:GetObject"],
145+
"Resource": [
146+
"arn:aws:s3:::<MY_BUCKET_NAME_1_/_MY_OPTIONAL_BUCKET_PATH_1>/*",
147+
"arn:aws:s3:::<MY_BUCKET_NAME_2_/_MY_OPTIONAL_BUCKET_PATH_2>/*"
148+
]
149+
},
150+
{
151+
"Sid": "DatadogRehydrateLogArchivesListBucket",
152+
"Effect": "Allow",
153+
"Action": "s3:ListBucket",
154+
"Resource": [
155+
"arn:aws:s3:::<MY_BUCKET_NAME_1>",
156+
"arn:aws:s3:::<MY_BUCKET_NAME_2>"
157+
]
158+
}
159+
]
160+
}
161+
```
162+
163+
### Añadir la delegación de roles a archivos de S3
164+
165+
Datadog solo admite búsquedas en archivos que se hayan configurado para utilizar la delegación de roles para conceder acceso. Una vez que hayas modificado el rol de IAM de Datadog para incluir la política de IAM anterior, asegúrate de que cada archivo de tu [página de configuración de archivos][3] tenga la combinación correcta de cuenta + rol de AWS.
166+
167+
[1]: https://app.datadoghq.com/account/settings#integrations/amazon-web-services
168+
[2]: /es/integrations/amazon-web-services/#aws-iam-permissions
169+
[3]: https://app.datadoghq.com/logs/pipelines/archives
170+
{{% /tab %}}
171+
172+
{{% tab "Azure Storage" %}}
173+
174+
Datadog utiliza un grupo de Azure AD con el rol Storage Blob Data Contributor asignado a la cuenta de almacenamiento de tus archivos para buscar eventos de log. Puedes otorgar este rol a tu cuenta de servicio de Datadog desde la página de Control de acceso (IAM) de tu cuenta de almacenamiento [al asignar el rol Storage Blob Data Contributor a tu aplicación de integración de Datadog][1].
175+
176+
[1]: /es/logs/archives/?tab=azurestorage#create-and-configure-a-storage-bucket
177+
{{% /tab %}}
178+
179+
{{% tab "Google Cloud Storage" %}}
180+
181+
Para buscar eventos de log desde tus archivos, Datadog utiliza una cuenta de servicio con el rol Storage Object Viewer. Puedes otorgar este rol a tu cuenta de servicio de Datadog desde la [página Google Cloud IAM Admin][1] al editar los permisos de la cuenta de servicio, añadir otro rol y, a continuación, seleccionar **Storage > Storage Object Viewer** (Almacenamiento > Storage Object Viewer**.
182+
183+
[1]: https://console.cloud.google.com/iam-admin/iam
184+
{{% /tab %}}
185+
{{< /tabs >}}
186+
187+
## Referencias adicionales
188+
189+
{{< partial name="whats-next/whats-next.html" >}}
190+
191+
[1]: https://docs.datadoghq.com/es/logs/log_configuration/archives/?tab=awss3&site=us
192+
[2]: https://docs.datadoghq.com/es/observability_pipelines/destinations/amazon_s3/?tab=docker
193+
[3]: https://docs.datadoghq.com/es/logs/log_configuration/archives/?tab=awss3&site=us
194+
[4]: https://app.datadoghq.com/logs/archive-search/new
195+
[5]: https://app.datadoghq.com/logs/archive-search/
196+
[6]: /es/logs/guide/logs-rbac/?tab=ui#restrict-access-to-logs
Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
---
2+
app_id: dbt-cloud
3+
app_uuid: b237cca3-e51e-400b-ae1d-960d0cab286b
4+
assets:
5+
dashboards:
6+
dbt Cloud Overview: assets/dashboards/dbt_cloud_overview.json
7+
integration:
8+
auto_install: false
9+
events:
10+
creates_events: false
11+
metrics:
12+
check:
13+
- dbt_cloud.runs.total
14+
metadata_path: metadata.csv
15+
prefix: dbt_cloud.
16+
service_checks:
17+
metadata_path: assets/service_checks.json
18+
source_type_id: 24633362
19+
source_type_name: DBT Cloud
20+
monitors:
21+
High runs error rate: assets/monitors/high_runs_error_rate.json
22+
author:
23+
homepage: https://www.datadoghq.com
24+
name: Datadog
25+
sales_email: [email protected]
26+
support_email: [email protected]
27+
categories:
28+
- cloud
29+
- developer tools
30+
- metrics
31+
custom_kind: integration
32+
dependencies: []
33+
display_on_public_website: true
34+
draft: false
35+
git_integration_title: dbt_cloud
36+
integration_id: dbt-cloud
37+
integration_title: dbt Cloud
38+
integration_version: ''
39+
is_public: true
40+
manifest_version: 2.0.0
41+
name: dbt_cloud
42+
public_title: dbt Cloud
43+
short_description: dbt Cloud アカウントから、実行の統計、ジョブ パフォーマンスなどを取得します。
44+
supported_os:
45+
- linux
46+
- windows
47+
- macos
48+
tile:
49+
changelog: CHANGELOG.md
50+
classifier_tags:
51+
- Category::Cloud
52+
- Category::Developer Tools
53+
- Category::Metrics
54+
- Offering::Integration
55+
- Submitted Data Type::Metrics
56+
- Supported OS::Linux
57+
- Supported OS::Windows
58+
- Supported OS::macOS
59+
configuration: README.md#Setup
60+
description: dbt Cloud アカウントから、実行の統計、ジョブ パフォーマンスなどを取得します。
61+
media:
62+
- caption: dbt Cloud ダッシュボード
63+
image_url: images/dbt-dashboard-screenshot.png
64+
media_type: image
65+
overview: README.md#Overview
66+
resources:
67+
- resource_type: blog
68+
url: https://www.datadoghq.com/blog/monitor-dbt-cloud-with-datadog/
69+
support: README.md#Support
70+
title: dbt Cloud
71+
---
72+
73+
<!-- SOURCED FROM https://github.com/DataDog/integrations-internal-core -->
74+
75+
76+
## 概要
77+
78+
Datadog の [dbt Cloud][1] インテグレーションを利用すると、dbt の実行、モデル、テストに関する主要なメトリクスを収集し、可視化できます。dbt Cloud を Datadog と統合することで、次のことが可能になります。
79+
80+
- dbt の実行のパフォーマンスと健全性を監視する
81+
- 実行、モデル、テストの実行時間、コンパイル時間、ステータス コードを可視化する
82+
- スタック内の他サービスのデータと dbt メトリクスを関連付ける
83+
84+
## セットアップ
85+
86+
### 前提条件
87+
88+
- dbt Cloud アカウント
89+
- 必要な権限を持つ API トークン
90+
91+
### ステップ 1: dbt Cloud で API Token を生成する
92+
93+
1. dbt Cloud で **User Profile** > **API Tokens** > **Service Tokens** を開きます。
94+
2. **+ Create Service Token** をクリックします。
95+
3. トークンの名前を入力します。
96+
4. トークンの権限を次のように設定します。
97+
- Administrative API メトリクスの場合は、トークンに runs と jobs へのアクセス権があることを確認します。
98+
- Discovery API メトリクスの場合 (任意) は、トークンに **Metadata API** の権限があり、プロジェクトで [Discovery API を有効化][2] 済みであることを確認します。
99+
5. **Save** をクリックし、生成された **API Token** をコピーします。
100+
101+
### ステップ 2: dbt Cloud アカウントを Datadog に接続する
102+
103+
1. Datadog プラットフォームで **Integrations** に移動します。
104+
2. **dbt Cloud** を検索し、インテグレーションを選択します。
105+
3. アカウント ドメイン、metadata ドメイン (任意)、API トークンを入力します。
106+
4. **Save** ボタンをクリックして設定を保存します。
107+
108+
## 収集データ
109+
110+
### メトリクス
111+
{{< get-metrics-from-git "dbt_cloud" >}}
112+
113+
114+
### サービス チェック
115+
116+
dbt Cloud インテグレーションには、サービス チェックは含まれません。
117+
118+
### イベント
119+
120+
dbt Cloud インテグレーションには、イベントは含まれません。
121+
122+
## 参考資料
123+
124+
お役に立つドキュメント、リンクや記事:
125+
- [Datadog で dbt Cloud を監視する][3]
126+
127+
## トラブルシューティング
128+
129+
お困りの際は、[Datadog サポート][4] までお問い合わせください。
130+
131+
[1]: https://www.getdbt.com/product/dbt-cloud
132+
[2]: https://docs.getdbt.com/docs/dbt-cloud-apis/discovery-api
133+
[3]: https://www.datadoghq.com/blog/monitor-dbt-cloud-with-datadog/
134+
[4]: https://docs.datadoghq.com/ja/help/

0 commit comments

Comments
 (0)