From 9cf428e303fd0984abf0146f4879b779d01b0982 Mon Sep 17 00:00:00 2001 From: guacbot Date: Wed, 17 May 2023 13:52:06 +0100 Subject: [PATCH] Translation Pipeline PR (#18162) * adding translations * updating translations * adding translations * adding translations * updating translations * adding translations * adding translations * adding translations * adding translations * adding translations * updating translations * updating translations * updating translations * updating translations * updating translations * updating translations * updating translations * updating translations --- content/fr/integrations/amazon_api_gateway.md | 41 +-- .../reactnative/advanced_configuration.md | 101 +++++- .../tracing/guide/trace-agent-from-source.md | 24 ++ .../trace_collection/compatibility/go.md | 166 ++++++++++ .../custom_instrumentation/ruby.md | 306 ++++++++++++++++++ .../ide_integrations/vscode/_index.md | 2 +- .../application_security/_index.md | 4 +- .../cloud_security_management/_index.md | 2 +- .../ja/getting_started/cloud_siem/_index.md | 7 +- .../observability_pipelines/_index.md | 8 +- .../feature_flag_tracking/_index.md | 11 +- .../ja/real_user_monitoring/roku/_index.md | 223 +++++++++++++ .../enabling/compatibility/_index.md | 8 + .../application_security/threats/_index.md | 6 +- .../vulnerability_management/_index.md | 80 +++++ .../serverless/azure_app_services/_index.md | 63 ++++ .../trace_collection/opentracing/_index.md | 27 ++ .../trace_context_propagation/_index.md | 26 ++ 18 files changed, 1064 insertions(+), 41 deletions(-) create mode 100644 content/fr/tracing/guide/trace-agent-from-source.md create mode 100644 content/fr/tracing/trace_collection/compatibility/go.md create mode 100644 content/fr/tracing/trace_collection/custom_instrumentation/ruby.md create mode 100644 content/ja/real_user_monitoring/roku/_index.md create mode 100644 content/ja/security/application_security/vulnerability_management/_index.md create mode 100644 content/ja/serverless/azure_app_services/_index.md create mode 100644 content/ja/tracing/trace_collection/opentracing/_index.md create mode 100644 content/ja/tracing/trace_collection/trace_context_propagation/_index.md diff --git a/content/fr/integrations/amazon_api_gateway.md b/content/fr/integrations/amazon_api_gateway.md index f9e7f3fe456c5..c302d465f445c 100644 --- a/content/fr/integrations/amazon_api_gateway.md +++ b/content/fr/integrations/amazon_api_gateway.md @@ -1,26 +1,29 @@ --- aliases: - - /fr/integrations/awsapigateway/ +- /fr/integrations/awsapigateway/ categories: - - cloud - - aws - - log collection -ddtype: crawler +- cloud +- aws +- log collection dependencies: [] -description: "Surveillez les erreurs d'AWS\_API\_Gateway, les hits et miss de cache et la latence des requêtes." -doc_link: 'https://docs.datadoghq.com/integrations/amazon_api_gateway/' +description: Surveillez les erreurs d'AWS API Gateway, les hits et miss de cache et + la latence des requêtes. +doc_link: https://docs.datadoghq.com/integrations/amazon_api_gateway/ draft: false git_integration_title: amazon_api_gateway has_logo: true +integration_id: amazon-api-gateway integration_title: Amazon API Gateway +integration_version: '' is_public: true kind: integration manifest_version: '1.0' name: amazon_api_gateway -public_title: "Intégration Datadog/Amazon\_API\_Gateway" -short_description: "Surveillez les erreurs Amazon\_API\_Gateway." +public_title: Intégration Datadog/Amazon API Gateway +short_description: Surveillez les erreurs Amazon API Gateway. version: '1.0' --- + ## Présentation Amazon API Gateway est un service entièrement géré qui permet aux développeurs de créer, publier, gérer, surveiller et sécuriser facilement des API quelque soit l'échelle. @@ -35,7 +38,7 @@ Si vous ne l'avez pas déjà fait, configurez d'abord [l'intégration Amazon We ### Collecte de métriques -1. Dans le [carré d'intégration AWS][2], assurez-vous que l'option `API Gateway` est cochée dans la section concernant la collecte des métriques. +1. Sur la [page de l'intégration AWS][2], vérifiez que `API Gateway` est activé dans l'onglet `Metric Collection`. 2. Ajoutez les autorisations suivantes à votre [stratégie IAM Datadog][3] afin de récupérer les tags personnalisés appliqués aux étapes API Gateway : @@ -44,6 +47,8 @@ Si vous ne l'avez pas déjà fait, configurez d'abord [l'intégration Amazon We 3. Configurez l'[intégration Datadog/AWS API Gateway][4]. +**Remarque** : si vous avez activé les métriques CloudWatch détaillées, vous devez les activer pour toutes les ressources ou toutes les routes d'une étape. Sinon, les valeurs agrégées dans Datadog seront incorrectes. + ### Collecte de logs Pour activer la journalisation API Gateway : @@ -52,7 +57,7 @@ Pour activer la journalisation API Gateway : 2. Sélectionnez l'API souhaitée et accédez à la section Stages. 3. Dans l'onglet **Logs**, activez **Enable CloudWatch Logs** et **Enable Access Logging**. 4. Sélectionnez le niveau `INFO` afin de récupérer l'ensemble des requêtes. -5. Assurez-vous d'inclure `apigateway` dans le nom de votre **groupe Cloudwatch**. +5. Assurez-vous que le nom de votre **groupe CloudWatch** commence par `api-gateway`. 6. Sélectionnez le format JSON (les formats CLF et CSV sont également pris en charge), et ajoutez ce qui suit dans le champ **Log format** : ```text @@ -73,10 +78,8 @@ Pour activer la journalisation API Gateway : #### Envoyer des logs à Datadog 1. Si vous ne l'avez pas déjà fait, configurez la [fonction AWS Lambda de collecte de logs avec Datadog][5]. -2. Une fois la fonction Lambda installée, ajoutez manuellement un déclencheur dans la console AWS sur le groupe de logs Cloudwatch qui contient vos logs API Gateway : - {{< img src="integrations/amazon_cloudwatch/cloudwatch_log_collection_1.png" alt="groupes de logs cloudwatch" popup="true" style="width:70%;">}} - Sélectionnez le groupe de logs CloudWatch correspondant, ajoutez un nom de filtre (vous pouvez toutefois laisser le filtre vide) et ajoutez le déclencheur : - {{< img src="integrations/amazon_cloudwatch/cloudwatch_log_collection_2.png" alt="Déclencheur cloudwatch" popup="true" style="width:70%;">}} +2. Une fois la fonction Lambda installée, ajoutez manuellement un déclencheur sur le groupe de logs CloudWatch qui contient vos logs API Gateway depuis la console AWS. + Sélectionnez le groupe de logs CloudWatch correspondant, ajoutez un nom de filtre (vous pouvez toutefois laisser le filtre vide) et ajoutez le déclencheur. Accédez ensuite à la [section Log de Datadog][6] pour commencer à explorer vos logs ! @@ -86,7 +89,7 @@ Accédez ensuite à la [section Log de Datadog][6] pour commencer à explorer vo {{< get-metrics-from-git "amazon_api_gateway" >}} -Chacune des métriques récupérées à partir d'AWS se verra assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s'y limiter, le hostname et les groupes de sécurité. +Chacune des métriques récupérées à partir d'AWS se voit assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s'y limiter, le hostname et les groupes de sécurité. ### Événements @@ -101,10 +104,10 @@ L'intégration AWS API Gateway n'inclut aucun check de service. Besoin d'aide ? Contactez [l'assistance Datadog][8]. [1]: https://docs.datadoghq.com/fr/integrations/amazon_web_services/ -[2]: https://app.datadoghq.com/account/settings#integrations/amazon_web_services +[2]: https://app.datadoghq.com/integrations/amazon-web-services [3]: https://docs.datadoghq.com/fr/integrations/amazon_web_services/#installation -[4]: https://app.datadoghq.com/account/settings#integrations/amazon_api_gateway -[5]: https://docs.datadoghq.com/fr/integrations/amazon_web_services/#create-a-new-lambda-function +[4]: https://app.datadoghq.com/integrations/amazon-api-gateway +[5]: https://docs.datadoghq.com/fr/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function [6]: https://app.datadoghq.com/logs [7]: https://github.com/DataDog/dogweb/blob/prod/integration/amazon_api_gateway/amazon_api_gateway_metadata.csv [8]: https://docs.datadoghq.com/fr/help/ \ No newline at end of file diff --git a/content/fr/real_user_monitoring/reactnative/advanced_configuration.md b/content/fr/real_user_monitoring/reactnative/advanced_configuration.md index 29d30c1fb17c1..b3f23b3c0dda2 100644 --- a/content/fr/real_user_monitoring/reactnative/advanced_configuration.md +++ b/content/fr/real_user_monitoring/reactnative/advanced_configuration.md @@ -1,6 +1,4 @@ --- -dependencies: -- https://github.com/DataDog/dd-sdk-reactnative/blob/main/docs/advanced_configuration.md description: Découvrez les options de configuration avancées disponibles pour votre configuration React Native. further_reading: @@ -15,7 +13,36 @@ title: Configuration avancée du RUM pour React Native --- ## Présentation -Si vous n'avez pas encore installé le SDK, consultez les [instructions de configuration intégrées à l'application][1] ou reportez-vous à la [documentation sur la configuration du RUM pour React Native][2]. +Si vous n'avez pas encore installé le SDK, consultez les [instructions de configuration dans l'application][1] ou reportez-vous à la [documentation sur la configuration du RUM pour React Native][2]. + +## Tests avec Jest + +Pour tester des applications avec `'@datadog/mobile-react-native'`, vous devrez potentiellement suivre des étapes supplémentaires. En effet, les environnements de testing ne comportent pas de modules Native. + +Datadog propose des simulations du package `'@datadog/mobile-react-native'`. Pour les utiliser avec [Jest][4], ajoutez ce qui suit dans le fichier de configuration de Jest : + +```javascript +jest.mock('@datadog/mobile-react-native', () => { + return require('@datadog/mobile-react-native/jest/mock'); +}); +``` + +Si vous initialisez le SDK avec le composant `DatadogProvider`, le suivi automatique des interactions, erreurs et ressources est désactivé dans vos tests. + +Toutes les méthodes de SDK sont simulées à l'aide de `jest.fn()`. Vous pouvez donc vérifier si une méthode de SDK Datadog a été appelée : + +```javascript +import { DdLogs } from '@datadog/mobile-react-native'; + +describe('App', () => { + it('calls DdLogs.debug on mount', () => { + renderer.create(); + expect(DdLogs.debug).toHaveBeenCalledWith('app started'); + }); +}); +``` + +Si vous n'utilisez pas Jest comme lanceur de test, vous devez créer les simulations pour votre lanceur. ## Instrumentation manuelle @@ -83,6 +110,67 @@ const spanId = await DdTrace.startSpan('foo', { custom: 42 }, Date.now()); DdTrace.finishSpan(spanId, { custom: 21 }, Date.now()); ``` +## Modifier ou ignorer des événements RUM + +Pour modifier les attributs d'un événement RUM avant de l'envoyer à Datadog, ou pour ignorer complètement un événement, utilisez l'API Event Mappers lors de la configuration du SDK RUM React Native : + +```javascript +const config = new DdSdkReactNativeConfiguration( + '', + '', + '', + true, // surveiller les interactions utilisateur (comme les boutons touchés) + true, // surveiller les ressources XHR + true // surveiller les erreurs +); +config.logEventMapper = event => event; +config.errorEventMapper = event => event; +config.resourceEventMapper = event => event; +config.actionEventMapper = event => event; +``` + +Chaque mapper correspond à une fonction dotée d'une signature `(T) -> T?`, où `T` est un type d'événement RUM concret. Cela permet de modifier des parties de l'événement avant son envoi, ou de l'ignorer complètement. + +Par exemple, pour censurer des informations sensibles du `message` d'une erreur RUM, implémentez une fonction `redacted` personnalisée et utilisez-la dans `errorEventMapper` : + +```javascript +config.errorEventMapper = event => { + event.message = redacted(event.message); + return event; +}; +``` + +Lorsque le mapper d'erreur, de ressource ou d'action renvoie la valeur `null`, l'événement est complètement ignoré et n'est donc pas envoyé à Datadog. + +Selon le type de l'événement, seules certaines propriétés peuvent être modifiées : + +| Type d'événement | Clé d'attribut | Description | +| ------------- | ------------------------ | ---------------------------------- | +| LogEvent | `logEvent.message` | Le message du log. | +| | `logEvent.context` | Les attributs personnalisés du log. | +| ActionEvent | `actionEvent.context` | Les attributs personnalisés de l'action. | +| ErrorEvent | `errorEvent.message` | Message d'erreur. | +| | `errorEvent.source` | La source de l'erreur. | +| | `errorEvent.stacktrace` | Stacktrace de l'erreur. | +| | `errorEvent.context` | Les attributs personnalisés de l'erreur. | +| | `errorEvent.timestampMs` | Le timestamp de l'erreur. | +| ResourceEvent | `resourceEvent.context` | Les attributs personnalisés de la ressource. | + +Les événements incluent des éléments de contexte supplémentaires : + +| Type d'événement | Clé de l'attribut de contexte | Description | +| ------------- | ------------------------------------------------ | ----------------------------------------------------------------------- | +| LogEvent | `logEvent.additionalInformation.userInfo` | Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. | +| | `logEvent.additionalInformation.attributes` | Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. | +| ActionEvent | `actionEvent.actionContext` | [GestureResponderEvent][5] correspond à l'action ou à `undefined`. | +| | `actionEvent.additionalInformation.userInfo` | Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. | +| | `actionEvent.additionalInformation.attributes` | Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. | +| ErrorEvent | `errorEvent.additionalInformation.userInfo` | Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. | +| | `errorEvent.additionalInformation.attributes` | Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. | +| ResourceEvent | `resourceEvent.resourceContext` | [XMLHttpRequest][6] correspond à la ressource ou à `undefined`. | +| | `resourceEvent.additionalInformation.userInfo` | Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. | +| | `resourceEvent.additionalInformation.attributes` | Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. | + ## Durées des ressources Grâce au suivi des ressources, vous pouvez recueillir les durées suivantes : @@ -193,5 +281,8 @@ const configuration = { {{< partial name="whats-next/whats-next.html" >}} [1]: https://app.datadoghq.com/rum/application/create -[2]: https://docs.datadoghq.com/fr/real_user_monitoring/reactnative -[3]: https://reactnative.dev/docs/interactionmanager#runafterinteractions \ No newline at end of file +[2]: /fr/real_user_monitoring/reactnative +[3]: https://reactnative.dev/docs/interactionmanager#runafterinteractions +[4]: https://jestjs.io/ +[5]: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/react-native/v0.70/index.d.ts#L548 +[6]: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest \ No newline at end of file diff --git a/content/fr/tracing/guide/trace-agent-from-source.md b/content/fr/tracing/guide/trace-agent-from-source.md new file mode 100644 index 0000000000000..6f8b59d466007 --- /dev/null +++ b/content/fr/tracing/guide/trace-agent-from-source.md @@ -0,0 +1,24 @@ +--- +aliases: +- /fr/tracing/faq/trace-agent-from-source/ +kind: guide +title: Installer l'Agent de trace depuis les sources +--- + +## Installation depuis les sources + +1. Installez `Go 1.11+`. Pour en savoir plus, suivez le guide détaillé disponible sur le [site Web officiel de Go][1] (en anglais). +2. Dupliquez le [référentiel de l'Agent Datadog][2]. +3. Exécutez la commande suivante à la racine du référentiel `datadog-agent` : + ```bash + go install ./cmd/trace-agent + ``` + +4. Exécutez l'Agent à l'aide de `trace-agent` (en supposant que le chemin `$GOPATH/bin` se trouve dans le `$PATH` de votre système). + +### Dépannage + +Consultez la sortie de l'Agent ou ses logs (`/var/log/datadog/trace-agent.log` sous Linux) pour vérifier que les traces ne comportent pas d'erreur et qu'elles parviennent à communiquer avec l'API Datadog. + +[1]: https://golang.org/dl +[2]: https://github.com/DataDog/datadog-agent \ No newline at end of file diff --git a/content/fr/tracing/trace_collection/compatibility/go.md b/content/fr/tracing/trace_collection/compatibility/go.md new file mode 100644 index 0000000000000..ea526c472c821 --- /dev/null +++ b/content/fr/tracing/trace_collection/compatibility/go.md @@ -0,0 +1,166 @@ +--- +aliases: +- /fr/tracing/compatibility_requirements/go +- /fr/tracing/setup_overview/compatibility_requirements/go +code_lang: go +code_lang_weight: 30 +description: Exigences de compatibilité pour le traceur Go +further_reading: +- link: tracing/trace_collection/dd_libraries/go + tag: Documentation + text: Instrumenter votre application +kind: documentation +title: Exigences de compatibilité Go +type: multi-code-lang +--- + +## Compatibilité + +La bibliothèque de tracing Datadog Go est open source. Consultez le [référentiel GitHub][1] pour en savoir plus. + +La bibliothèque de tracing Datadog Go inclut une [stratégie de compatibilité][2] pour les versions de Go. Les deux dernières versions de Go sont entièrement prises en charge, tandis que la troisième version la plus récente est considérée comme en [maintenance][3]. Les versions plus anciennes peuvent fonctionner, mais aucune prise en charge n'est fournie par défaut. Pour toute demande spéciale, [contactez l'assistance][4]. + +Vous devez exécuter la version 5.21.1 de l'Agent Datadog ou une version plus récente. + +### Intégrations + +#### Compatibilité des frameworks + +Intégrez le traceur go avec la liste de frameworks Web ci-dessous via l'un des packages d'assistance suivants : + +**Remarque** : la [documentation sur les intégrations][5] contient une description détaillée des packages pris en charge et de leurs API, ainsi que des exemples d'utilisation. + +| Framework | Type de prise en charge | Documentation GoDoc de Datadog | +|-------------------|-----------------|--------------------------------------------------------------------------| +| [Gin][6] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/gin-gonic/gin][7] | +| [Gorilla Mux][8] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/gorilla/mux][9] | +| [gRPC][10] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc][11] | +| [gRPC v1.2][10] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc.v12][12] | +| [chi][13] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/go-chi/chi][14] | +| [echo v4][15] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo.v4][16] | +| [echo v3][15] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo][17] | +| [Fiber][18] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/gofiber/fiber.v2][19] | + +#### Compatibilité des bibliothèques + +Le traceur Go prend en charge les datastores et les bibliothèques suivants. + +| Bibliothèque | Type de prise en charge | Exemples et documentation | +|-------------------------|-----------------|---------------------------------------------------------------------------------| +| [AWS SDK][20] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go/aws][21] | +| [AWS SDK v2][75] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go-v2/aws][76] | +| [Elasticsearch][22] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/olivere/elastic][23] | +| [Cassandra][24] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/gocql/gocql][25] | +| [GraphQL][26] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/graph-gophers/graphql-go][27] | +| [HTTP][28] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/net/http][29] | +| [HTTP router][30] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/julienschmidt/httprouter][31] | +| [Redis (go-redis)][32] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis][33] | +| [Redis (go-redis-v8)][34]| Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis.v8][35] | +| [Redis (redigo)][36] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/garyburd/redigo][37] | +| [Redis (new redigo)][38]| Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/gomodule/redigo][39] | +| [SQL][40] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/database/sql][41] | +| [SQLx][42] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/jmoiron/sqlx][43] | +| [MongoDB][44] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/go.mongodb.org/mongo-driver/mongo][45] | +| [MongoDB (mgo)][73] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/globalsign/mgo][46] | +| [BuntDB][47] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/tidwall/buntdb][48] | +| [LevelDB][49] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/syndtr/goleveldb/leveldb][50] | +| [miekg/dns][51] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/miekg/dns][52] | +| [Kafka (confluent)][53] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/confluentinc/confluent-kafka-go][54] | +| [Kafka (sarama)][55] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/Shopify/sarama][56] | +| [API Google][57] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/api][58] | +| [go-restful][59] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/emicklei/go-restful][60] | +| [Twirp][61] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/twitchtv/twirp][62] | +| [Vault][63] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/vault][64] | +| [Consul][65] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/consul][66] | +| [Gorm][67] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/jinzhu/gorm][68] | +| [Gorm v2][69] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/gorm.io/gorm.v1][70] | +| [Kubernetes][71] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/k8s.io/client-go/kubernetes][72] | +| [Memcache][73] | Prise en charge complète | [gopkg.in/DataDog/dd-trace-go.v1/contrib/bradfitz/gomemcache/memcache][74] | + + +Les packages doivent être importés de la façon suivante : + +```go +import "gopkg.in/DataDog/dd-trace-go.v1/contrib//" +``` + +## Pour aller plus loin + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://github.com/DataDog/dd-trace-go +[2]: https://github.com/DataDog/dd-trace-go#support-policy +[3]: https://github.com/DataDog/dd-trace-go#support-maintenance +[4]: https://www.datadoghq.com/support/ +[5]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib +[6]: https://gin-gonic.com +[7]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/gin-gonic/gin +[8]: http://www.gorillatoolkit.org/pkg/mux +[9]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/gorilla/mux +[10]: https://github.com/grpc/grpc-go +[11]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc +[12]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc.v12 +[13]: https://github.com/go-chi/chi +[14]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/go-chi/chi +[15]: https://github.com/labstack/echo +[16]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo.v4 +[17]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo +[18]: https://github.com/gofiber/fiber +[19]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/gofiber/fiber.v2 +[20]: https://aws.amazon.com/sdk-for-go +[21]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go/aws +[22]: https://github.com/olivere/elastic +[23]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/olivere/elastic +[24]: https://github.com/gocql/gocql +[25]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/gocql/gocql +[26]: https://github.com/graph-gophers/graphql-go +[27]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/graph-gophers/graphql-go +[28]: https://golang.org/pkg/net/http +[29]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/net/http +[30]: https://github.com/julienschmidt/httprouter +[31]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/julienschmidt/httprouter +[32]: https://github.com/go-redis/redis +[33]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis +[34]: https://github.com/go-redis/redis/v8 +[35]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis.v8 +[36]: https://github.com/garyburd/redigo +[37]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/garyburd/redigo +[38]: https://github.com/gomodule/redigo +[39]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/gomodule/redigo +[40]: https://golang.org/pkg/database/sql +[41]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/database/sql +[42]: https://github.com/jmoiron/sqlx +[43]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/jmoiron/sqlx +[44]: https://github.com/mongodb/mongo-go-driver +[45]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/go.mongodb.org/mongo-driver/mongo +[46]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/globalsign/mgo +[47]: https://github.com/tidwall/buntdb +[48]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/tidwall/buntdb +[49]: https://github.com/syndtr/goleveldb +[50]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/syndtr/goleveldb/leveldb +[51]: https://github.com/miekg/dns +[52]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/miekg/dns +[53]: https://github.com/confluentinc/confluent-kafka-go +[54]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/confluentinc/confluent-kafka-go +[55]: https://github.com/Shopify/sarama +[56]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/Shopify/sarama +[57]: https://github.com/googleapis/google-api-go-client +[58]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/api +[59]: https://github.com/emicklei/go-restful +[60]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/emicklei/go-restful +[61]: https://github.com/twitchtv/twirp +[62]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/twitchtv/twirp +[63]: https://github.com/hashicorp/vault +[64]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/vault +[65]: https://github.com/hashicorp/consul +[66]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/consul +[67]: https://github.com/jinzhu/gorm +[68]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/jinzhu/gorm +[69]: https://gorm.io/ +[70]: https://gopkg.in/DataDog/dd-trace-go.v1/contrib/gorm.io/gorm.v1 +[71]: https://github.com/kubernetes/client-go +[72]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/k8s.io/client-go/kubernetes +[73]: https://github.com/bradfitz/gomemcache/memcache +[74]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/bradfitz/gomemcache/memcache +[75]: https://aws.github.io/aws-sdk-go-v2/docs/ +[76]: https://pkg.go.dev/gopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go-v2/aws \ No newline at end of file diff --git a/content/fr/tracing/trace_collection/custom_instrumentation/ruby.md b/content/fr/tracing/trace_collection/custom_instrumentation/ruby.md new file mode 100644 index 0000000000000..1aa27b9aa01d4 --- /dev/null +++ b/content/fr/tracing/trace_collection/custom_instrumentation/ruby.md @@ -0,0 +1,306 @@ +--- +aliases: +- /fr/tracing/opentracing/ruby +- /fr/tracing/manual_instrumentation/ruby +- /fr/tracing/custom_instrumentation/ruby +- /fr/tracing/setup_overview/custom_instrumentation/ruby +code_lang: ruby +code_lang_weight: 20 +description: Instrumentez manuellement votre application Ruby afin d'envoyer des traces + personnalisées à Datadog. +further_reading: +- link: tracing/other_telemetry/connect_logs_and_traces + tag: Documentation + text: Associer vos logs à vos traces +- link: tracing/glossary/ + tag: Documentation + text: Explorer vos services, ressources et traces +kind: documentation +title: Instrumentation Ruby personnalisée avec la bibliothèque Datadog +type: multi-code-lang +--- +
+Si vous n'avez pas encore lu les instructions sur l'instrumentation automatique et la configuration, lisez la section Tracer des applications Ruby. +
+ +Cette page décrit les méthodes à suivre pour configurer et personnaliser l'observabilité avec la solution APM Datadog. + +## Ajout de tags + +Ajoutez des [tags de span][1] personnalisés à vos [spans][2] pour personnaliser la visibilité sur vos applications dans Datadog. Les tags de span sont appliqués à vos traces entrantes, ce qui vous permet de corréler le comportement observé avec des informations au niveau du code, comme le niveau du commerçant, le montant du paiement ou l'ID de l'utilisateur. + +### Ajouter des tags de span personnalisés + +Ajoutez des tags personnalisés à vos spans correspondant à une valeur dynamique au sein du code de votre application, comme `customer.id`. + +{{< tabs >}} +{{% tab "Span active" %}} +Accédez à la [span][1] active pour n'importe quelle méthode dans votre code. + +**Remarque** : si la méthode est appelée et qu'aucune span est active, `active_span` renvoie `nil`. + +```ruby +require 'ddtrace' + +# get '/shopping_cart/:customer_id', to: 'shopping_cart#index' +class ShoppingCartController < ApplicationController + # GET /shopping_cart + def index + # Récupérer la span active et définir customer_id -> 254889 + Datadog::Tracing.active_span&.set_tag('customer.id', params.permit([:customer_id])) + + # [...] + end + + # POST /shopping_cart + def create + # [...] + end +end +``` + +[1]: /fr/tracing/glossary/#spans +{{% /tab %}} + +{{% tab "Spans instrumentées manuellement" %}} + +Ajoutez directement des [tags][1] aux objets `Datadog::Span` en appelant `#set_tag` : + +```ruby +# Un exemple d'endpoint Sinatra, +# avec le tracing Datadog autour de la requête. +get '/posts' do + Datadog::Tracing.trace('web.request') do |span| + span.set_tag('http.url', request.path) + span.set_tag('', '') + end +end +``` + + +[1]: /fr/tracing/glossary/#span-tags +{{% /tab %}} +{{< /tabs >}} + +### Ajouter des tags à l'ensemble des spans + +Ajoutez des [tags][1] à l'ensemble des [spans][2] en configurant l'option `tags` du traceur : + +```ruby +Datadog.configure do |c| + c.tags = { 'team' => 'qa' } +end +``` + +Vous pouvez aussi utiliser la variable d'environnement `DD_TAGS` pour définir des tags sur toutes les spans d'une application. Pour en savoir plus sur les variables d'environnement Ruby, consultez la [documentation relative à la configuration][3]. + +### Définir des erreurs sur une span + +Il existe deux manières de définir une erreur sur une span : + +- Vous pouvez appeler `span.set_error` et transmettre l'objet d'exception. Cela permet d'extraire automatiquement le type d'erreur, le message et la backtrace. + +```ruby +require 'ddtrace' +require 'timeout' + +def example_method + span = Datadog::Tracing.trace('example.trace') + puts 'some work' + sleep(1) + raise StandardError, "This is an exception" +rescue StandardError => error + Datadog::Tracing.active_span&.set_error(error) + raise +ensure + span.finish +end + +example_method() +``` + +- Vous avez également la possibilité d'utiliser `tracer.trace`, qui définit par défaut le type d'erreur, le message et la backtrace. Pour ce faire, vous pouvez vous servir de l'option `on_error`, qui définit le gestionnaire invoqué lorsqu'un bloc est fourni à `trace` et que ce bloc génère une erreur. L'élément Proc reçoit les arguments `span` et `error`. Par défaut, `on_error` définit l'erreur sur la span. + +Comportement par défaut pour `on_error` : + +```ruby +require 'ddtrace' +require 'timeout' + +def example_method + puts 'some work' + sleep(1) + raise StandardError, "This is an exception" +end + +Datadog::Tracing.trace('example.trace') do |span| + example_method() +end +``` + +Comportement personnalisé pour `on_error` : + +```ruby +require 'ddtrace' +require 'timeout' + +def example_method + puts 'some work' + sleep(1) + raise StandardError.new "This is a special exception" +end + +custom_error_handler = proc do |span, error| + span.set_tag('custom_tag', 'custom_value') + span.set_error(error) unless error.message.include?("a special exception") +end + +Datadog::Tracing.trace('example.trace', on_error: custom_error_handler) do |span| + example_method() +end +``` + +## Ajout de tags + +Si vous n'utilisez pas une instrumentation de bibliothèque compatible (voir la [compatibilité des bibliothèques][4]), vous pouvez instrumenter manuellement votre code. Utilisez la méthode `Datadog::Tracing.trace` pour tracer votre code. Celle-ci peut être ajoutée autour de n'importe quel code Ruby. + +Pour tracer du code Ruby, vous pouvez utiliser la méthode `Datadog::Tracing.trace` : + +```ruby +Datadog::Tracing.trace(name, resource: resource, **options) do |span| + # Incorporer le code que vous souhaitez instrumenter dans ce bloc. + # La span peut également être modifiée ici. + # Exemple : changement de nom de ressource, définition de tags, etc. +``` + +`name` est une `string` décrivant le type d'opération effectuée (p. ex., `'web.request'` ou `'request.parse'`). + +`resource` est une `String` correspondant au nom de l'action tracée. Les traces associées à un même nom de ressource seront regroupées pour la collecte de métriques. Les ressources sont généralement spécifiques à un domaine, tel qu'une URL, une requête, etc. Exemples : 'Article#submit', http://example.com/articles/list. + +Pour obtenir la liste de toutes les `**options` disponibles, consultez le [guide de référence][5]. + +### Créer manuellement une nouvelle span + +Programmez la création de spans autour d'un bloc de code. Les spans créées à l'aide de cette méthode s'intègrent automatiquement aux autres mécanismes de tracing. Autrement dit, si une trace a déjà commencé, la span manuelle aura son appelant comme span parent. De la même manière, une méthode tracée appelée à partir du bloc de code incorporé aura la span manuelle comme parent. + +```ruby +# Un exemple d'endpoint Sinatra, +# avec le tracing Datadog autour de la requête, +# une requête de base de données et des étapes de rendu. +get '/posts' do + Datadog::Tracing.trace('web.request', service: '', resource: 'GET /posts') do |span| + # Tracer l'appel activerecord + Datadog::Tracing.trace('posts.fetch') do + @posts = Posts.order(created_at: :desc).limit(10) + end + + # Ajouter des tags APM + span.set_tag('http.method', request.request_method) + span.set_tag('posts.count', @posts.length) + + # Tracer le rendu du modèle + Datadog::Tracing.trace('template.render') do + erb :index + end + end +end +``` + +### Post-traitement de traces + +Certaines applications nécessitent que les traces soient modifiées ou filtrées avant d'être envoyées à Datadog. Le pipeline de traitement vous permet de créer des *processeurs* servant à mettre en place un tel comportement. + +#### Filtrage + +Vous pouvez utiliser le processeur `Datadog::Tracing::Pipeline::SpanFilter` pour supprimer les spans lorsque le bloc renvoie une valeur truthy : + +```ruby +Datadog::Tracing.before_flush( + # Supprimer les spans associées à une ressource spécifique + Datadog::Tracing::Pipeline::SpanFilter.new { |span| span.resource =~ /PingController/ }, + # Supprimer les spans acheminées vers localhost + Datadog::Tracing::Pipeline::SpanFilter.new { |span| span.get_tag('host') == 'localhost' } +) +``` + +#### Traitement + +Vous pouvez utiliser le processeur `Datadog::Tracing::Pipeline::SpanProcessor` pour modifier des spans : + +```ruby +Datadog::Tracing.before_flush( + # Supprimer le texte correspondant au champ resource + Datadog::Tracing::Pipeline::SpanProcessor.new { |span| span.resource.gsub!(/password=.*/, '') } +) +``` + +#### Processeur personnalisé + +Un processeur peut être n'importe quel objet répondant à un `#call` et acceptant `trace` comme argument (qui est un `array` de `Datadog::Span`). + +Par exemple, avec une syntaxe de bloc raccourcie : + +```ruby +Datadog::Tracing.before_flush do |trace| + # Logique de traitement… + trace +end +``` + +L'exemple suivant implémente un processeur afin d'appliquer une logique de post-traitement complexe : + +```ruby +Datadog::Tracing.before_flush do |trace| + trace.spans.each do |span| + originalPrice = span.get_tag('order.price')) + discount = span.get_tag('order.discount')) + + # Définir un tag à partir d'un calcul basé sur d'autre tags + if (originalPrice != nil && discount != nil) + span.set_tag('order.value', originalPrice - discount) + end + end + trace +end +``` + +Pour une classe de processeur personnalisé : + +```ruby +class MyCustomProcessor + def call(trace) + # Logique de traitement… + trace + end +end + +Datadog::Tracing.before_flush(MyCustomProcessor.new) +``` + +Dans les deux cas, la méthode du processeur *doit* renvoyer l'objet `trace`. La valeur renvoyée est ensuite passée au processeur suivant dans le pipeline. + + +## Configuration de l'Agent et du client de tracing + +D'autres paramètres peuvent être configurés au niveau du client de tracing et de l'Agent Datadog pour la propagation en contexte avec les en-têtes B3, ainsi que pour empêcher des ressources spécifiques d'envoyer des traces à Datadog (si vous ne souhaitez pas que ces ces traces soient prises en compte pour le calcul des métriques, comme pour les checks de santé). + +### Propager le contexte avec l'injection et l'extraction d'en-têtes + +Vous pouvez injecter et extraire des en-têtes afin de configurer la propagation du contexte des traces distribuées. Consultez la [section dédiée][6] pour en savoir plus. + + +### Filtrage de ressources + +Il est possible d'exclure des traces en fonction de leur nom de ressource, afin d'empêcher le trafic Synthetic (tel que les checks de santé) d'envoyer des traces à Datadog. Pour filtrer des ressources et configurer d'autres paramètres de sécurité et de personnalisation, consulter la documentation relative à la [sécurité][7]. + +## Pour aller plus loin + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /fr/tracing/glossary/#span-tags +[2]: /fr/tracing/glossary/#spans +[3]: /fr/tracing/setup/ruby/#environment-and-tags +[4]: /fr/tracing/compatibility_requirements/ruby/ +[5]: /fr/tracing/trace_collection/dd_libraries/ruby/#manual-instrumentation +[6]: /fr/tracing/trace_collection/trace_context_propagation/ruby/ +[7]: /fr/tracing/security \ No newline at end of file diff --git a/content/ja/developers/ide_integrations/vscode/_index.md b/content/ja/developers/ide_integrations/vscode/_index.md index a2503696dfc8f..aaeaa74249554 100644 --- a/content/ja/developers/ide_integrations/vscode/_index.md +++ b/content/ja/developers/ide_integrations/vscode/_index.md @@ -37,7 +37,7 @@ Datadog 拡張機能を利用することで、以下のことが可能になり ## セットアップ -[Datadog 拡張機能][6]をインストールすることができます。 +Visual Studio Marketplace から [Datadog 拡張機能][6]をインストールします。 ## Synthetic テストをローカルで実行する diff --git a/content/ja/getting_started/application_security/_index.md b/content/ja/getting_started/application_security/_index.md index c1d2f821b68d8..288339c76061c 100644 --- a/content/ja/getting_started/application_security/_index.md +++ b/content/ja/getting_started/application_security/_index.md @@ -84,13 +84,13 @@ done{{< /code-block >}} [1]: https://app.datadoghq.com/services?env=prod&hostGroup=%2A&lens=Security [2]: /ja/security/application_security/enabling/ -[3]: /ja/security/application_security/threats/setup_and_configure/#configuring-a-client-ip-header +[3]: /ja/security/application_security/threats/library_configuration/#configuring-a-client-ip-header [4]: /ja/security/application_security/how-appsec-works/ [5]: /ja/security/application_security/threats/add-user-info/ [6]: https://app.datadoghq.com/security?query=%40workflow.rule.type%3A%22Application%20Security%22&column=time&order=desc&product=appsec&view=signal&viz=stream&start=1674824351640&end=1675429151640&paused=false [7]: https://app.datadoghq.com/security/appsec [8]: https://app.datadoghq.com/security/appsec/traces -[9]: /ja/security/application_security/threats/setup_and_configure/#exclude-specific-parameters-from-triggering-detections +[9]: /ja/security/application_security/threats/library_configuration/#exclude-specific-parameters-from-triggering-detections [10]: https://app.datadoghq.com/security/appsec/reports-configuration [11]: https://app.datadoghq.com/security/configuration/notification-rules [12]: /ja/security/notifications/rules/ \ No newline at end of file diff --git a/content/ja/getting_started/cloud_security_management/_index.md b/content/ja/getting_started/cloud_security_management/_index.md index aa9de1fc1e1c2..95167576a13b5 100644 --- a/content/ja/getting_started/cloud_security_management/_index.md +++ b/content/ja/getting_started/cloud_security_management/_index.md @@ -24,7 +24,7 @@ title: Cloud Security Management の概要 ## フェーズ 1: デプロイメント -1. [Datadog Agent (バージョン 7.40 以上)][4] をインストールします。 +1. [Datadog Agent (バージョン 7.44 以上)][4] をインストールします。 2. クラウドリソースとインフラストラクチャーに対して、CSM を有効にします。 - **CWS**: [Kubernetes][5]、[Docker][6]、[ホストベース][7]のインストール。 - **CSPM**: [AWS][10]、[Azure][11]、[GCP][12]、[Kubernetes][8]、[Docker][9] の手順。 diff --git a/content/ja/getting_started/cloud_siem/_index.md b/content/ja/getting_started/cloud_siem/_index.md index f4c01da18a91f..9d11f29bbbfbb 100644 --- a/content/ja/getting_started/cloud_siem/_index.md +++ b/content/ja/getting_started/cloud_siem/_index.md @@ -11,15 +11,18 @@ further_reading: - link: https://learn.datadoghq.com/courses/intro-to-cloud-siem tag: ラーニングセンター text: Cloud SIEM 入門コース -- link: https://www.datadoghq.com/blog/automate-end-to-end-processes-with-datadog-workflows/ +- link: https://www.datadoghq.com/blog/automate-security-tasks-with-workflows-and-cloud-siem/ tag: ブログ - text: Datadog Workflows でエンドツーエンドプロセスを自動化し、イベントに迅速に対応する + text: Datadog Workflows と Cloud SIEM で、一般的なセキュリティタスクを自動化し、脅威の先を行く - link: https://app.datadoghq.com/workflow/blueprints?selected_category=SECURITY tag: App text: Workflows のセキュリティ設計図で応答を自動化する - link: /security/cloud_siem/guide/aws-config-guide-for-cloud-siem/ tag: Documentation text: Cloud SIEM の AWS 構成ガイド +- link: /security/cloud_siem/guide/google-cloud-config-guide-for-cloud-siem/ + tag: Documentation + text: Cloud SIEM のための Google Cloud 構成ガイド - link: /security/notifications/variables/ tag: Documentation text: 通知をカスタマイズするための通知変数について diff --git a/content/ja/getting_started/observability_pipelines/_index.md b/content/ja/getting_started/observability_pipelines/_index.md index a542c228be6d0..f23da512c12c6 100644 --- a/content/ja/getting_started/observability_pipelines/_index.md +++ b/content/ja/getting_started/observability_pipelines/_index.md @@ -76,7 +76,7 @@ helm repo add datadog https://helm.datadoghq.com helm repo update ``` ```shell -helm update --install \ +helm upgrade --install \ opw datadog/observability-pipelines-worker \ -f aws_eks.yaml ``` @@ -95,7 +95,7 @@ helm repo add datadog https://helm.datadoghq.com helm repo update ``` ```shell -helm update --install \ +helm upgrade --install \ opw datadog/observability-pipelines-worker \ -f azure_aks.yaml ``` @@ -114,7 +114,7 @@ helm repo add datadog https://helm.datadoghq.com helm repo update ``` ```shell -helm update --install \ +helm upgrade --install \ opw datadog/observability-pipelines-worker \ -f google_gke.yaml ``` @@ -175,7 +175,7 @@ Google GKE では、Datadog は SSD でバックアップされた `premium-rwo` Datadog Agent のログとメトリクスを観測可能性パイプラインワーカーに送信するには、以下のように Agent の構成を更新してください。 ```yaml -vector: +observability_pipelines_worker: logs.enabled: true # 観測可能性パイプラインワーカーで TLS/SSL が有効になっている場合、プロトコルを https に調整します logs.url: "http://:8282" diff --git a/content/ja/real_user_monitoring/feature_flag_tracking/_index.md b/content/ja/real_user_monitoring/feature_flag_tracking/_index.md index 2fadffa0f529c..9b8a1ba3a302a 100644 --- a/content/ja/real_user_monitoring/feature_flag_tracking/_index.md +++ b/content/ja/real_user_monitoring/feature_flag_tracking/_index.md @@ -6,14 +6,17 @@ further_reading: text: 機能フラグデータ収集の設定 - link: /real_user_monitoring/explorer/ tag: Documentation - text: RUM エクスプローラー + text: RUM エクスプローラーについて +- link: https://www.datadoghq.com/blog/feature-flag-tracking/ + tag: ブログ + text: Datadog RUM の機能フラグ追跡によるリリースの安全性の確保 kind: documentation title: 機能フラグ追跡 --- -{{< callout url="#" btn_hidden="true" >}} -RUM の機能フラグ追跡は非公開ベータ版です。アクセスをリクエストするには、サポート (support@datadoghq.com) までご連絡ください。 -{{< /callout >}} +
+ 機能フラグ追跡はベータ版です。 +
## 概要 diff --git a/content/ja/real_user_monitoring/roku/_index.md b/content/ja/real_user_monitoring/roku/_index.md new file mode 100644 index 0000000000000..cf9f8e107e126 --- /dev/null +++ b/content/ja/real_user_monitoring/roku/_index.md @@ -0,0 +1,223 @@ +--- +further_reading: +- link: https://github.com/DataDog/dd-sdk-roku + tag: Github + text: dd-sdk-roku ソースコード +- link: /real_user_monitoring + tag: Documentation + text: Datadog RUM を探索する +is_beta: true +kind: documentation +title: RUM Roku チャンネルモニタリング +--- + +{{< site-region region="gov" >}} +
RUM for Roku は、US1-FED Datadog サイトではご利用いただけません。
+{{< /site-region >}} + +{{< site-region region="us,us3,us5,eu,ap1" >}} +
RUM for Roku はベータ版です。
+{{< /site-region >}} + +## 概要 + +Datadog Real User Monitoring (RUM) を使用すると、チャンネルの個々のユーザーのリアルタイムパフォーマンスとユーザージャーニーを視覚化して分析できます。 + +Datadog Roku SDK は、Roku OS 10 以降の BrightScript チャンネルをサポートしています。 + +## セットアップ + +1. SDK を依存関係として宣言します。 +2. Datadog でアプリケーションの詳細を指定します。 +3. ライブラリを初期化します。 +4. チャンネルをインスツルメンテーションします。 + +### SDK を依存関係として宣言 + +#### ROPM の使用 (推奨) + +`ROPM` は Roku プラットフォームのパッケージマネージャーです (NPM をベースにしています)。Roku プロジェクトでまだ `ROPM` を使用していない場合は、[スタートアップガイド][1]をお読みください。プロジェクトが `ROPM` を使用するようにセットアップされたら、以下のコマンドを使用して Datadog の依存関係をインストールすることができます。 + +```shell +ropm install datadog-roku +``` + +### 手動で設定する + +プロジェクトが `ROPM` を使用していない場合は、[Roku SDK][2] の zip アーカイブをダウンロードし、プロジェクトのルートフォルダで解凍して、ライブラリを手動でインストールします。 + +プロジェクトの `components` と `source` フォルダの両方に `roku_modules/datadogroku` サブフォルダがあることを確認します。 + +### Datadog でアプリケーションの詳細を指定する + +1. [**UX Monitoring** > **RUM Applications** > **New Application**][3] へ移動します。 +2. アプリケーションタイプとして **Roku** を選択し、新しいアプリケーション名を入力して一意の Datadog アプリケーション ID とクライアントトークンを生成します。 +3. クライアント IP またはジオロケーションデータの自動ユーザーデータ収集を無効にするには、これらの設定のチェックボックスをオフにします。詳しくは、[RUM Roku データ収集][4]をご覧ください。 + + {{< img src="real_user_monitoring/roku/roku-new-application.png" alt="Datadog で Roku 用 RUM アプリケーションを作成する" style="width:90%;">}} + +データの安全性を確保するため、クライアントトークンを使用する必要があります。`dd-sdk-roku` ライブラリの構成に [Datadog API キー][5]のみを使用した場合、クライアント側で Roku チャンネルの BrightScript コード内で公開されます。 + +クライアントトークンのセットアップについて、詳しくは[クライアントトークンに関するドキュメント][6]を参照してください。 + +### ライブラリの初期化 + +初期化スニペットで、環境名を設定します。詳しくは、[タグの使用方法][7]を参照してください。 + +{{< site-region region="us" >}} +```brightscript +sub RunUserInterface(args as dynamic) + screen = CreateObject("roSGScreen") + scene = screen.CreateScene("MyScene") + screen.show() + + datadogroku_initialize({ + clientToken: "", + applicationId: "" + site: "us1", + env: "", + sessionSampleRate: 100, ' the percentage (integer) of sessions to track + launchArgs: args + }) + + ' complete your channel setup here +end sub +``` +{{< /site-region >}} + +{{< site-region region="eu" >}} +```brightscript +sub RunUserInterface(args as dynamic) + screen = CreateObject("roSGScreen") + scene = screen.CreateScene("MyScene") + screen.show() + + datadogroku_initialize({ + clientToken: "", + applicationId: "" + site: "eu1", + env: "", + sessionSampleRate: 100, ' the percentage (integer) of sessions to track + launchArgs: args + }) + + ' complete your channel setup here +end sub +``` +{{< /site-region >}} + +{{< site-region region="us3" >}} +```brightscript +sub RunUserInterface(args as dynamic) + screen = CreateObject("roSGScreen") + scene = screen.CreateScene("MyScene") + screen.show() + + datadogroku_initialize({ + clientToken: "", + applicationId: "" + site: "us3", + env: "", + sessionSampleRate: 100, ' the percentage (integer) of sessions to track + launchArgs: args + }) + + ' complete your channel setup here +end sub +``` +{{< /site-region >}} + +{{< site-region region="us5" >}} +```brightscript +sub RunUserInterface(args as dynamic) + screen = CreateObject("roSGScreen") + scene = screen.CreateScene("MyScene") + screen.show() + + datadogroku_initialize({ + clientToken: "", + applicationId: "" + site: "us5", + env: "", + sessionSampleRate: 100, ' the percentage (integer) of sessions to track + launchArgs: args + }) + + ' complete your channel setup here +end sub +``` +{{< /site-region >}} + +{{< site-region region="ap1" >}} +```brightscript +sub RunUserInterface(args as dynamic) + screen = CreateObject("roSGScreen") + scene = screen.CreateScene("MyScene") + screen.show() + + datadogroku_initialize({ + clientToken: "", + applicationId: "" + site: "ap1", + env: "", + sessionSampleRate: 100, ' the percentage (integer) of sessions to track + launchArgs: args + }) + + ' complete your channel setup here +end sub +``` +{{< /site-region >}} + +### チャンネルをインスツルメンテーションする + +すべてのリソースの自動追跡を有効にするには [**RUM リソースの追跡**][8]、イベントにカスタムグローバル情報やユーザー情報を追加するには[**ユーザーセッションのリッチ化**][9]を参照してください。 + +#### RUM View の追跡 + +[ユーザーセッション][4]を論理的なステップに分割するには、次のコードを使用して手動で View を開始します。チャンネル内で新しい画面に移動するたびに、新しい RUM View に対応する必要があります。 + +```brightscript + viewName = "VideoDetails" + viewUrl = "components/screens/VideoDetails.xml" + m.global.datadogRumAgent.callfunc("startView", viewName, viewUrl) +``` + +#### RUM Actions の追跡 + +RUM Actions は、ユーザーがチャンネルと行うインタラクションを表します。アクションは以下のように Datadog に転送することができます。 + +```brightscript + targetName = "playButton" ' the name of the SG Node the user interacted with + actionType = "click" ' the type of interaction, should be one of "click", "back", or "custom" + m.global.datadogRumAgent.callfunc("addAction", { target: targetName, type: actionType}) +``` + +#### RUM エラーの追跡 + +例外を投げる可能性のある操作を行った場合、以下のように Datadog にエラーを転送することができます。 + +```brightscript + try + doSomethingThatMightThrowAnException() + catch error + m.global.datadogRumAgent.callfunc("addError", error) + end try +``` + + + + +## その他の参考資料 + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://github.com/rokucommunity/ropm +[2]: https://github.com/DataDog/dd-sdk-roku +[3]: https://app.datadoghq.com/rum/application/create +[4]: /ja/real_user_monitoring/roku/data_collected/ +[5]: /ja/account_management/api-app-keys/#api-keys +[6]: /ja/account_management/api-app-keys/#client-tokens +[7]: /ja/getting_started/tagging/using_tags/#rum--session-replay +[8]: /ja/real_user_monitoring/roku/advanced_configuration/#track-rum-resources +[9]: /ja/real_user_monitoring/roku/advanced_configuration/#enrich-user-sessions \ No newline at end of file diff --git a/content/ja/security/application_security/enabling/compatibility/_index.md b/content/ja/security/application_security/enabling/compatibility/_index.md index 0f60ec7d92b63..8c6bdebd45aa9 100644 --- a/content/ja/security/application_security/enabling/compatibility/_index.md +++ b/content/ja/security/application_security/enabling/compatibility/_index.md @@ -11,6 +11,14 @@ title: 互換性要件 type: multi-code-lang --- +各言語のトレーシングライブラリに対して、以下の ASM 機能をサポートしています。 + +| ASM の機能 | Java | .NET | Node.js | Python | Go | Ruby | PHP | +| -------------------------------- | ----------------------------|----------------------------|----------------------------|----------------------------|----------------------------|----------------------------|----------------------------| +| Threat Detection
| 1.8.0
| 2.23.0
| 3.31.1
| 1.9.0
| 1.47.0
| 1.9.0
| 0.84.0
| +| Threat Protection
--> IP ブロッキング
--> 不審リクエストブロッキング
--> ユーザーブロッキング | 1.9.0
| 2.26.0
|
--> 3.11.0
--> 非対応

--> 3.11.0 | 1.10.0
|
--> 1.48.0
--> v1.50.0

--> 1.48.0 | 非対応
| 0.86.0
| +| Risk Management
--> サードパーティの脆弱性検出
--> カスタムコードの脆弱性検出 | 1.1.4
| 2.16.0
| Node.js 12+ の場合は 2.23.0、Node.js 14+ の場合は 3.10.0
| 1.5.0
| 非対応
| 非対応
| 非対応
| + フレームワークの互換性と機能サポートの詳細については、アプリケーションの言語を選択してください。 {{< partial name="security-platform/appsec-languages.html" >}} diff --git a/content/ja/security/application_security/threats/_index.md b/content/ja/security/application_security/threats/_index.md index cf56ed2ccb358..3b0a64c0d8e42 100644 --- a/content/ja/security/application_security/threats/_index.md +++ b/content/ja/security/application_security/threats/_index.md @@ -3,12 +3,12 @@ further_reading: - link: /security/application_security/threats/add-user-info/ tag: ドキュメント text: ユーザーアクティビティの追跡 -- link: /security/application_security/threats/setup_and_configure/ +- link: /security/application_security/threats/library_configuration/ tag: ドキュメント text: ASM のセットアップを構成する - link: /security/application_security/risk_management/ tag: ドキュメント - text: リスク管理 + text: Application Vulnerability Management - link: /security/application_security/how-appsec-works/ tag: ドキュメント text: ASM の仕組み @@ -16,7 +16,7 @@ kind: documentation title: Application Threat Monitoring and Protection --- -ASM Threat Monitoring and Protection は、APM でインスツルメンテーションされたアプリケーションからのトレーステレメトリーを使用して、観測された挙動を既知の攻撃パターンと比較することにより、実行中のサービスに対する脅威や攻撃を特定します。 +ASM Threat Monitoring and Protection は、APM でインスツルメンテーションされたアプリケーションからのトレーステレメトリーを使用して、観測された挙動を既知の攻撃パターンと比較したり、ビジネスロジックの乱用を特定することにより、実行中のサービスに対する脅威や攻撃を特定します。 Threat Monitoring によって提起されたセキュリティシグナルは、サービスの健全性とパフォーマンスを監視するために、すでによく訪れているビューに要約され、表示されます。APM の[サービスカタログ][1]と個々のサービスページでは、アプリケーションの脅威シグナルをすばやく把握でき、すばやくクリックしてシグナルを調査し、攻撃者をブロックすることができます。 diff --git a/content/ja/security/application_security/vulnerability_management/_index.md b/content/ja/security/application_security/vulnerability_management/_index.md new file mode 100644 index 0000000000000..73682856efc3e --- /dev/null +++ b/content/ja/security/application_security/vulnerability_management/_index.md @@ -0,0 +1,80 @@ +--- +aliases: +- /ja/security/application_security/risk_management/ +further_reading: +- link: /security/application_security/how-appsec-works/ + tag: Documentation + text: Datadog におけるアプリケーションセキュリティの仕組み +- link: /security/application_security/enabling/ + tag: Documentation + text: サービスでアプリケーションセキュリティを有効にする +kind: documentation +title: Application Vulnerability Management +--- + +## 概要 + +Application Vulnerability Management には、サービスのオープンソース依存部分で検出された脆弱性について警告する検出機能が組み込まれています。その情報の詳細は、[Vulnerability Explorer][3] に表示され、重大度、影響を受けるサービス、潜在的に脆弱なインフラストラクチャー、および表面化したリスクを解決するための改善手順が特定されます。 + +[ASM の互換性][6]を確認し、ご利用のサービスが対応しているかどうかをご確認ください。 + +## 脆弱性対策と改善策の検討 + +Vulnerability Explorer は、Application Vulnerability Management によって検出された脆弱性の完全なリストをすべてのサービスにわたって表示し、重大度に基づいて脆弱性を並べ、問題を調査して優先順位を付けることができるようにグループ化およびフィルター機能を提供します。オープンソースの脆弱性については、影響を受けるサービスの数、影響を受けるライブラリの言語、およびその脆弱性が最後に検出された時刻を表示します。 + +{{< img src="security/application_security/appsec-vuln-explorer2.png" alt="Application Vulnerability Management エクスプローラーページ。" style="width:100%;" >}} + +特定の脆弱性を選択すると、どのサービスが影響を受けているかなど、その詳細が表示されます。ここから、どのコンテナやインフラストラクチャーがその脆弱性の影響を受ける可能性があるかを調べることができるので、リスクの範囲についてより詳しく知ることができます。これは、改善タスクの優先順位を決定するための貴重な情報となります。 + +ASM 内では、脆弱性の重大度は、攻撃の有無や脆弱性が検出された環境のビジネス上の機密性を考慮し、基本スコアから修正されます。例えば、本番環境が検出されない場合は、重大度が軽減されます。 + +調整後の脆弱性スコアは、各サービスの完全なコンテキストを含んでいます。 + +- 元の脆弱性の重大度 +- 不審なリクエストの証拠 +- 機密性の高い環境、インターネットに接続された環境 + +{{< img src="security/application_security/vulnerability-score-modified.png" alt="変更された重大度スコアを表示する脆弱性詳細ページ" style="width:100%;" >}} + +また、エクスプローラーでは検出された脆弱性に対する改善勧告が表示され、脆弱性のステータスを変更したり、チームメンバーに割り当ててさらに検討させたりすることができます。また、各脆弱性の背景を理解するのに役立つ Web サイトや情報源へのリンクやリファレンスのコレクションも含まれています。 + +{{< img src="security/application_security/appsec-vuln-details2.png" alt="Application Vulnerability Management の脆弱性の詳細ページでは、影響を受けるサービス、インフラストラクチャーへのリンク、推奨される改善策、および詳細情報へのリンクが表示されます。" style="width:100%;" >}} + +## オープンソースの既知の脆弱性の検出 + +Application Vulnerability Management は、アプリケーションで使用されているオープンソースライブラリをランタイムに検出し、それらに関連するセキュリティ脆弱性を報告します。これを行うために、Application Vulnerability Management は、様々な公共のオープンソースソフトウェアの既知の脆弱性データソースと、Datadog のセキュリティ調査チームが取得したデータを組み合わせています。Datadog はソースコードをスキャンせず、アプリケーションの実行時の挙動をもとに分析します。 + +## カスタムコードの脆弱性の検出 + +
カスタムコードの脆弱性 (未知の脆弱性) の検出は、非公開ベータ版です。サポートに連絡して、この機能へのアクセスをリクエストしてください。
+ +Application Vulnerability Management は、オープンソースやサードパーティのライブラリに加え、お客様のサービスのカスタムコード (アプリケーションのビジネスロジックを一から実装する独自コード) に問題を発見することができます。 + +Datadog は、ソースコードをスキャンすることなく、脆弱性が存在するファイル名と行番号を示すことができます。 + +発見できるカスタムコードの脆弱性は以下の通りです。 + +- Insecure Cipher +- Insecure Hashing +- Weak Randomness +- SQL インジェクション +- パストラバーサル +- LDAP インジェクション +- コマンドインジェクション + +## APM ビューにおけるリスク情報 + +Application Vulnerability Management は、APM がすでに収集している情報をリッチ化し、現在の脆弱性勧告と一致するライブラリにフラグを立てます。潜在的に脆弱なサービスは、[APM サービスカタログ][2]に組み込まれたセキュリティビューで直接ハイライト表示されます。 + +{{< img src="security/application_security/vulns-in-service-catalog.png" alt="APM サービスカタログに表示される脆弱性情報" style="width:100%;" >}} + +## その他の参考資料 + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /ja/help/ +[2]: https://app.datadoghq.com/services?lens=Security +[3]: https://app.datadoghq.com/security/appsec/vm +[4]: https://app.datadoghq.com/security/appsec +[5]: https://app.datadoghq.com/security/appsec/landing +[6]: /ja/security/application_security/enabling/compatibility \ No newline at end of file diff --git a/content/ja/serverless/azure_app_services/_index.md b/content/ja/serverless/azure_app_services/_index.md new file mode 100644 index 0000000000000..e408180ef2f07 --- /dev/null +++ b/content/ja/serverless/azure_app_services/_index.md @@ -0,0 +1,63 @@ +--- +aliases: +- /ja/infrastructure/serverless/azure_app_services/ +further_reading: +- link: /integrations/azure_app_services/ + tag: Documentation + text: Azure App Service +- link: /integrations/azure_app_service_environment/ + tag: Documentation + text: Azure App Service Environment +- link: https://www.datadoghq.com/blog/azure-app-service-extension/ + tag: ブログ + text: Azure App Service の Datadog 拡張機能で Monitor .NET ウェブアプリを監視 +- link: https://www.datadoghq.com/pricing/?product=apm--continuous-profiler#apm--continuous-profiler-what-is-considered-as-a-host-for-azure-app-services + tag: 料金 + text: Azure App Service APM 価格設定 +- link: https://www.datadoghq.com/blog/deploy-dotnet-core-azure-app-service/ + tag: ブログ + text: ASP.NET Core アプリケーションを Azure App Service にデプロイする +kind: documentation +title: Azure App Service のモニタリング +--- + +## 概要 + +Microsoft [Azure App Service][1] は、インフラストラクチャーを管理せずに Web アプリやモバイルバックエンド、イベント駆動型関数、RESTful API の構築とホスティングを行うことが可能な統合型のサーバーレスリソースです。あらゆる規模のワークロードのホスティングのほか、オートスケーリングと高可用性オプションにも対応しています。 + +Datadog では Azure App Service に属するすべてのリソースタイプのモニタリングが可能です。 + +- [Azure インテグレーション][2]を使用した[アプリ][2]および[関数][3]向けの Azure Monitor メトリクス。 +- [Azure App Service ビュー][4]を使用して、問題をすばやく特定し、Azure App Service リソース間の関係をマッピングし、コストとパフォーマンスに関する洞察を得ることができます。 +- API を通じてカスタムメトリクスの送信を行います。 +- [イベントハブ][6]から[リソースログ][5]を送信します。 + +Datadog は、Basic、Standard、Premium プランにおいて、以下の Azure App Service のワークロードランタイムの監視機能を追加提供します。 + +| OS | ランタイム |ステータス|Documentation| +|----|---------|----|----| +|Windows|.NET|GA|[Windows .NET のセットアップ][7]| +|Windows|Java|ベータ|[Windows Java のセットアップ][8]| +|Linux|.NET|ベータ|[Linux ドキュメント][9]| +|Linux|Node|ベータ|[Linux ドキュメント][9]| + +機能: +- 自動インスツルメンテーションを用いた完全分散型 APM トレーシング +- カスタマイズされた APM サービスとトレースビューは、関連する Azure App Service のメトリクスとメタデータを表示します +- スパンのカスタマイズが可能な、手動 APM インスツルメンテーション +- アプリケーションログへの `Trace_ID` 挿入 +- [DogStatsD][7] を使用したカスタムメトリクス + +## その他の参考資料 + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /ja/integrations/azure/#log-collection +[2]: /ja/tracing/trace_collection/dd_libraries/ +[3]: https://registry.hub.docker.com/r/datadog/serverless-init +[4]: /ja/metrics/custom_metrics/dogstatsd_metrics_submission/ +[5]: /ja/getting_started/site/ +[6]: /ja/getting_started/tagging/unified_service_tagging/ +[7]: /ja/serverless/azure_app_services/azure_app_services_windows?tab=net#setup +[8]: /ja/serverless/azure_app_services/azure_app_services_windows?tab=java#setup +[9]: /ja/serverless/azure_app_services/azure_app_services_linux \ No newline at end of file diff --git a/content/ja/tracing/trace_collection/opentracing/_index.md b/content/ja/tracing/trace_collection/opentracing/_index.md new file mode 100644 index 0000000000000..f55d08353477a --- /dev/null +++ b/content/ja/tracing/trace_collection/opentracing/_index.md @@ -0,0 +1,27 @@ +--- +aliases: +- /ja/tracing/trace_collection/open_standards/ +kind: documentation +title: OpenTracing インスツルメンテーションセットアップ +type: multi-code-lang +--- + +[OpenTelemetry][1] や [`ddtrace`][2] のカスタムインスツルメンテーションがうまく機能しない場合、サポートされている各言語は [OpenTracing][3] データを Datadog に送信するサポートも備えています。OpenTracing はアーカイブされ、プロジェクトはサポートされていません。 + +言語に合わせて続きを読む: + +{{< whatsnext desc="OpenTracing を使用してトレースを送信するようにアプリケーションを設定します。" >}} + {{< nextlink href="/tracing/trace_collection/opentracing/java" >}}Java{{< /nextlink >}} + {{< nextlink href="/tracing/trace_collection/opentracing/python" >}}Python{{< /nextlink >}} + {{< nextlink href="/tracing/trace_collection/opentracing/ruby" >}}Ruby{{< /nextlink >}} + {{< nextlink href="/tracing/trace_collection/opentracing/go" >}}Go{{< /nextlink >}} + {{< nextlink href="/tracing/trace_collection/opentracing/nodejs" >}}NodeJS{{< /nextlink >}} + {{< nextlink href="/tracing/trace_collection/opentracing/php" >}}PHP{{< /nextlink >}} + {{< nextlink href="/tracing/trace_collection/opentracing/dotnet" >}}.NET{{< /nextlink >}} +{{< /whatsnext >}} + +
+ +[1]: /ja/tracing/trace_collection/otel_instrumentation/ +[2]: /ja/tracing/trace_collection/custom_instrumentation/ +[3]: https://opentracing.io/docs/ \ No newline at end of file diff --git a/content/ja/tracing/trace_collection/trace_context_propagation/_index.md b/content/ja/tracing/trace_collection/trace_context_propagation/_index.md new file mode 100644 index 0000000000000..a7c79a5824687 --- /dev/null +++ b/content/ja/tracing/trace_collection/trace_context_propagation/_index.md @@ -0,0 +1,26 @@ +--- +aliases: null +description: Datadog、B3、W3C のヘッダーを抽出・挿入し、分散型トレーシングのコンテキストを伝搬させます。 +further_reading: +- link: tracing/glossary/ + tag: Documentation + text: APM の用語を理解する +- link: https://www.datadoghq.com/blog/monitor-otel-with-w3c-trace-context/ + tag: ブログ + text: W3C Trace Context に対応した OTel インスツルメンテーションされたアプリのモニタリング +kind: documentation +title: トレースコンテキストの伝搬 +type: multi-code-lang +--- + + +{{< partial name="apm/apm-context-propagation" >}} + + +
+ +## その他の参考資料 + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /ja/opentelemetry/otel_tracing/ \ No newline at end of file