Détails de la configuration du fichier platform-settings.json

Installation et mise à niveau > Installation de ThingWorx > Installation manuelle > Annexes relatives à l'installation > Détails de la configuration du fichier platform-settings.json

Le fichier platform-settings.json permet aux administrateurs d'ajuster les paramètres pour l'optimisation et est accessible dans les téléchargements logiciels. Pour connaître les paramètres spécifiques au clustering haute disponibilité, consultez la rubrique Paramètres de la plateforme pour la haute disponibilité ThingWorx.

L'exemple ci-dessous contient toutes les options. Seul le fournisseur de persistance est requis.

{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"DatabaseWriteRetryAttempts": 10,
"EnableBackup": true,
"EnableClusteredMode": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"MetricsLoggingFrequency": 30,
"MetricsLoggingLevel": "WARN",
"MetricsReportingEnabled": true,
"SessionUpdateDelay": 60,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30,
"MaxSearchItems": 100000
},
"DomainConfiguration": {
"trustedDomains":[
"www.example1.com",
"www.example2.com",
"images.example3.com",
"localhost"
],
"ignoreTrustedDomains": false
}
"SolutionCentralSettings": {
"SolutionCentralHost": "<Solution Central host name>",
"KeyStorePath": "<Path for your keystore>",
"KeyStorePass": "<Password for your keystore>"
},
"AdministratorUserSettings": {
"InitialPassword": "changeme"
},
"ContentTypeSettings": {
"supportedMediaEntityContentTypes" : ["image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"]
},
"OrchestrationSettings": {
"EnableOrchestration": true,
"QueueHost": "localhost",
"QueuePort": 5672,
"QueueName": "256mb",
"QueueUsername": "flowuser",
"QueuePassword": "encrypt.queue.password",
"QueueVHost": "orchestration",
"TurnOffScopesApprovalPopup": true
},
"ExtensionPackageImportPolicy": {
"importEnabled": false,
"allowJarResources": false,
"allowJavascriptResources": false,
"allowCSSResources": false,
"allowJSONResources": false,
"allowWebAppResources": false,
"allowEntities": false,
"allowExtensibleEntities": false,
"haCompatibilityImportLevel": "WARN"
},
"ClusteredModeSettings": {
"PlatformId": "platform1",
"CoordinatorHosts": "localhost:2181",
"ModelSyncPollInterval": 100
},
"LicensingConnectionSettings": {
"username": "<username>",
"password": "<password>",
"timeout":"60",
"useProxy": false,
"proxyHost": "<proxyHost>",
"proxyPort" : "<proxy port>",
"proxyScheme": "<http or https>",
"proxyUseNTLM": true,
"proxyUsername": "<user>",
"proxyPassword": "<user password>",
"proxyWorkstation": "<dummyWorkstation>",
"proxyDomain": "<dummyDomain>"
},
"MetricsUserSettings": {
"InitialPassword": "<password>"
},
"PersistenceProviderPackageConfigs": {
"H2PersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 30,
"acquireRetryDelay": 1000,
"checkoutTimeout": 2000,
"networkTimeout": 900000,
"idleConnectionTestPeriod": 6,
"initialPoolSize": 10,
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 36000,
"maxPoolSize": 100,
"maxStatements": 0,
"maxStatementsPerConnection": 50,
"minPoolSize": 10,
"numHelperThreads": 6,
"password": "password",
"tableLockTimeout": 10000,
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
},
"PostgresPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"networkTimeout": 900000,
"queryTimeout": 600000,
"driverClass": "org.postgresql.Driver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:postgresql://localhost:5432/thingworx",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "password",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
},
"MssqlPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"networkTimeout": 900000,
"queryTimeout": 600000,
"driverClass": "com.microsoft.sqlserver.jdbc.SQLServerDriver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx;",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "Password@123",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "msadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
}
},
"cache": {
"provider-type": "com.thingworx.cache.ignite.IgniteCacheProvider",
"ignite": {
"instance-name": "twx-core-server",
"client-mode": false,
"address-resolver": {
"type": "zookeeper",
"connection": "localhost:2181"
}
}
}
}
}

Les paramètres networkTimeout, queryTimeout et producerTimeout ne doivent être utilisés qu'à partir de ThingWorx 9.2.8 et versions ultérieures et de ThingWorx 9.3.3 et versions ultérieures.

Paramètres platform-settings.json

Paramètres de base

Paramètre

Par défaut

Description

BackupStorage

/ThingworxBackupStorage

Nom du répertoire de toutes les sauvegardes.

DatabaseLogRetentionPolicy

Nombre de jours pendant lesquels les journaux de base de données sont conservés.

DatabaseWriteRetryAttempts

Nombre maximal de tentatives de persistance des entrées de la base de données par le système en cas de perte de connexion.

EnableBackup

true

Détermine si les sauvegardes sont conservées.

EnableClusteredMode

false

Détermine si ThingWorx s'exécutera en tant que cluster ou en tant que serveur autonome.

EnableSystemLogging

false

Détermine si la journalisation système est activée.

N'activez pas ce paramètre, à moins d'y être invité par le support ThingWorx.

EnableSSO

false

Définissez ce paramètre sur Vrai pour activer l'authentification unique pour ThingWorx Platform. Lorsque l'authentification unique est activée, toute authentification est redirigée vers le serveur d'autorisation central configuré dans le fichier sso-settings.json. L'authentification WebSocket Edge n'est pas affectée.

FileRepositoryRoot

/ThingworxStorage

Le répertoire où le référentiel de fichiers racine est créé. L'emplacement par défaut est suffisant pour les déploiements autonomes. Pour les déploiements ThingWorx haute disponibilité (HA), le référentiel doit se trouver sur un système de fichiers partagé accessible par tous les serveurs ThingWorx.

HTTPRequestHeaderMaxLength

2000

Longueur maximale autorisée pour les valeurs d'en-tête des requêtes HTTP.

HTTPRequestParameterMaxLength

2000

Longueur maximale autorisée pour les valeurs de paramètre des requêtes HTTP.

InternalAesCryptographicKeyLength

128

Longueur de clé utilisée lors de la génération d'une clé AES symétrique. Les valeurs prises en charge sont 128, 192 et 256.

Si la longueur de clé est supérieure à 128 et que les politiques Java ne sont pas configurées pour utiliser cette taille de clé, le chiffrement et le déchiffrement échoueront.

MetricsLoggingFrequency

Fréquence en minutes à laquelle les mesures collectées par la plateforme sont enregistrées dans le journal de l'application.

MetricsLoggingLevel

WARN

Niveau de journal auquel les mesures collectées par la plateforme sont enregistrées dans le journal de l'application. La valeur peut être l'une des valeurs suivantes : WARN, DEBUG, TRACE, INFO ou ERROR.

MetricsReportingEnabled

n/a

Détermine si les données de mesure des performances sont envoyées à PTC. Vous pouvez également configurer cette option dans le sous-système de plateforme. Pour plus d'informations sur la collecte de données dans ThingWorx, consultez la rubrique Collecte de données dans ThingWorx.

SessionUpdateDelay

Durée, en secondes, ajoutée au lastUpdateTime, après laquelle le lastUpdateTime de la session sera mis à jour. Si plusieurs demandes sont reçues pendant le délai, seule la première demande mettra à jour le lastUpdateTime. La valeur par défaut est de 60 secondes.

Storage

/ThingworxStorage

Répertoire de création/localisation de tous les dossiers de stockage (à l'exception du stockage de sauvegarde).

ScriptTimeout

Nombre maximal de secondes pendant lesquelles un script peut s'exécuter avant que la plateforme ThingWorx n'y mette fin.

Les scripts de la plateforme sont arrêtés automatiquement s'ils s'exécutent plus longtemps que le nombre de secondes configuré pour ce délai d'expiration.

Prenez en considération la sensibilité et/ou l'importance des informations gérées par les scripts lors de la configuration de leur délai d'inactivité. Bien qu'il soit important de mettre fin à des scripts après une période donnée pour des raisons de sécurité, le faire prématurément peut entraîner une perte de données. En raison de la flexibilité de ThingWorx Platform, il existe des cas d'utilisation susceptibles de nécessiter des délais d'inactivité plus courts ou plus longs que la valeur par défaut.

MaxSearchItems

100000

Autorisez les utilisateurs à augmenter la limite de recherche par défaut en fonction du nombre d'entités présentes dans l'environnement.

Le paramètre MaxSearchItems défini par les API du groupe de ressources SearchFunctions dans ThingWorx Composer sera prioritaire sur la valeur définie dans le fichier platform-settings.json.

Si MaxSearchItems est défini sur une valeur supérieure à 100k, transmettez les critères de recherche appropriés en fonction du cas d'utilisation afin de réduire le temps de recherche pour récupérer le nombre requis d'entités.

Définissez le paramètre MaxSearchItems en fonction du nombre d'entités dans ThingWorx Platform. Ne le définissez sur la valeur entière maximale : 2,147,483,647.

Redémarrez votre environnement ThingWorx pour appliquer la nouvelle valeur de MaxSearchItems.

Paramètres de configuration du domaine

Paramètre

Par défaut

Description

ignoreTrustedDomains

true

Si ce marqueur est défini sur true, tous les appels HTTP externes via des entités de média sont autorisés. S'il est défini sur false, seuls les appels HTTP vers les domaines répertoriés sous trustedDomains sont autorisés.

trustedDomains

N/A

Liste de domaines vérifiés et approuvés que les utilisateurs peuvent utiliser pour accéder aux médias sur l'application composite via l'objet d'entité de média.

Actuellement, seuls les protocoles HTTP et HTTPS sont pris en charge. Les demandes adressées à des médias externes via tout autre protocole seront toujours rejetées.

Paramètres Solution Central

Paramètre

Par défaut

Description

SolutionCentralHost

sc.thingworx.com

Nom d'hôte Solution Central

SolutionCentralPort

443

Détails du port Solution Central

Ne définissez pas SolutionCentralPort si la valeur est définie par défaut.

KeyStorePath

/ThingworxPlatform/sc-keystore

Chemin d'accès au KeyStore

KeyStorePass

Aucun

Mot de passe de votre KeyStore

Pour le chiffrement de votre mot de passe, définissez KeyStorePass sur encrypt.sc.password.

Paramètres de ThingWorx Flow

Ces propriétés ne s'appliquent que si ThingWorx Flow est installé sur ThingWorx Foundation. Ces valeurs doivent être définies dans les fichiers de configuration de ThingWorx Flow et de RabbitMQ et ne doivent pas être modifiées, sauf si elles le sont dans les deux applications.

Paramètre

Par défaut

Description

EnableOrchestration

vrai

Indique si ThingWorx Flow est activé dans ThingWorx Foundation.

QueueHost

localhost

Nom d'hôte RabbitMQ

QueuePort

5672

Port RabbitMQ

QueueName

256mb

Nom de la file d'attente RabbitMQ

QueueUsername

flowuser

Nom d'utilisateur de la file d'attente RabbitMQ

QueuePassword

encrypt.queue.password

Mot de passe de la file d'attente RabbitMQ

Le mot de passe est automatiquement chiffré lors de l'installation de ThingWorx Flow sur la même machine que ThingWorx Foundation.

Si ThingWorx Flow n'est pas installé sur le même ordinateur que ThingWorx Foundation, vous devez chiffrer ce mot de passe.

QueueVHost

orchestration

Nom VHost RabbitMQ

TurnOffScopesApprovalPopup

faux

Définissez la valeur sur true pour désactiver l'affichage des fenêtres d'approbation des demandes d'octroi durant le processus de connexion.

Paramètres de la politique d'importation des packages d'extension

L'importation d'extensions est désactivée par défaut pour tous les utilisateurs. Utilisez les paramètres suivants pour configurer la fonctionnalité d'importation d'extensions. Pour plus d'informations, consultez la rubrique Importation d'extensions.

Paramètre

Description

Par défaut

Exemples

importEnabled

Contrôle le niveau supérieur qui définit l'autorisation (=true) ou l'interdiction (=false) d'importer des extensions.

false

• "importEnabled": false : l'importation d'extensions est impossible, même si d'autres paramètres ExtensionPackageImportPolicy sont définis sur "true".

• "importEnabled": true : transmet l'importation d'extensions à l'ensemble suivant de paramètres allow<Content>Resources (voir les lignes ci-dessous).

Si les paramètres allow<Content>Resources sont définis sur "false", une extension vide (qui ne contient aucune entité, entité extensible ou ressource) peut être importée. Cette configuration n'est cependant pas particulièrement utile. Ainsi, si importEnabled est défini sur "true", au moins un autre paramètre allow<Content>Resources doit également être défini sur "true".

allowJarResources

Autorise l'importation d'extensions avec ressources JAR.

false

• "allowJarResources": true : autorise l'importation d'extensions déclarant dans leur manifeste les fichiers JAR comme ressources JAR.

• "allowJarResources": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste les fichiers JAR comme ressources JAR.

allowJavascriptResources

Autorise l'importation d'extensions avec ressources JavaScript.

false

• "allowJavascriptResources": true : autorise l'importation d'extensions déclarant dans leur manifeste les ressources du fichier de l'interface utilisateur JavaScript de type JS comme ressources JavaScript.

• "allowJavascriptResources": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste les ressources du fichier de l'interface utilisateur JavaScript de type JS comme ressources JavaScript.

allowCSSResources

Autorise l'importation d'extensions avec ressources CSS.

false

• "allowCSSResources": true : autorise l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur CSS.

• "allowCSSResources": false : n'autorise pas l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur CSS.

allowJSONResources

Autorise l'importation d'extensions contenant des ressources JSON (par exemple, des fichiers de localisation).

false

• "allowJSONResources": true : autorise l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur JSON.

• "allowJSONResources": false : n'autorise pas l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur JSON.

allowWebAppResources

Autorise l'importation d'extensions avec ressources WebApp.

false

• "allowWebAppResources": true : autorise l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur WebApp.

• "allowWebAppResources": false : n'autorise pas l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur WebApp.

allowEntities

Autorise l'importation d'extensions contenant des entités non extensibles. Voici quelques exemples d'entités non extensibles :

• Clé d'application

• Authentificateur

• Tableau de bord

• Définition d'analyse de données

• Forme de données

• GenericContentEntity et classes enfant dérivées comme les définitions d'état et de style, le thème stylistique, etc.

• Groupe

• Table de localisation

• Logarithme

• Application composite

• Entité de média

• Menu

• ModeledServiceProviderEntity et classes enfant comme le contenu de notification

• Réseau

• Définition de notification

• Organisation

• Fournisseur de persistance

• PersistenceProviderPackage et classes enfant dérivées

• Projet

• Forme d'objet

• Modèle d'objet

• Utilisateur

• Vocabulaire et classes enfant dérivées comme DataTagVocabulary et ModelTagVocabulary

false

• "allowEntities": true : autorise l'importation d'extensions déclarant dans leur manifeste des entités non extensibles.

• "allowEntities": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste des entités non extensibles.

allowExtensibleEntities

Autorise l'importation d'extensions contenant des entités non extensibles. Voici quelques exemples d'entités extensibles :

• DirectoryService et classes enfant dérivées

• ExtensionPackage

• Ressource et classes enfant dérivées contenant des services/fonctions personnalisés utilisés comme ressources similaires aux ressources standard comme InfoTableFunctions, EntityServices et EncryptionServices.

Les sous-systèmes standard qui ne font pas partie d'extensions ne sont pas affectés.

• ScriptFunctionLibrary et classes enfant dérivées

• Sous-système et classes enfant dérivées

Les sous-systèmes standard qui ne font pas partie d'extensions ne sont pas affectés.

• Package d'objet

• Widget

false

• "allowExtensibleEntities": true : autorise l'importation d'extensions déclarant dans leur manifeste des entités extensibles.

• "allowExtensibleEntities": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste des entités extensibles.

haCompatibilityImportLevel

Lorsque vous exécutez ThingWorx en mode cluster, vous pouvez limiter l'importation des extensions à celles dont le marqueur haCompatibility est défini sur true dans les métadonnées des extensions. Le paramètre par défaut WARN permet l'importation, mais génère un message d'avertissement dans le journal de l'application. Vous pouvez définir le paramètre sur DENY ; dans ce cas, l'importation échoue et une erreur est générée dans le journal de l'application.

WARN

• "haCompatibilityImportLevel": "WARN" : les importations d'extension réussissent et des avertissements sont générés pour les extensions dont le marqueur "haCompatible" : "TRUE" n'est pas défini.

• "haCompatibilityImportLevel": "DENY" : seules les extensions dont le marqueur est "haCompatible" : "TRUE" seront importées. Toutes les autres importations d'extension échouent et des messages d'erreur sont générés.

Paramètres du mode cluster

Paramètres spécifiques à l'exécution de ThingWorx en mode cluster. Tous les paramètres sont ignorés si le paramètre EnableClusteredMode est défini sur false.

Paramètre	Par défaut	Description
PlatformId	Aucune	Identificateur unique pour chaque noeud du cluster. Cet ID sera affiché dans les journaux agrégés. Il doit être alphanumérique et inférieur à 32 caractères. Il doit correspondre au modèle "^[a-zA-Z0-9]{1,32}$".
CoordinatorHosts	Aucune	Liste délimitée par des virgules des serveurs Apache ZooKeeper utilisés pour coordonner la priorité de ThingWorx. Le modèle de chaîne est IP:port (par exemple, "127.0.0.1:2181, 127.0.0.2:2181").
ZKNamespace	ThingWorx	Chemin du noeud racine utilisé pour effectuer le suivi des informations dans ZooKeeper pour le cluster. Il est requis lors de l'exécution de plusieurs clusters utilisant le même ZooKeeper. Les limitations de dénomination de ZooKeeper s'appliquent (reportez-vous à la page http://zookeeper.apache.org/doc/current/zookeeperProgrammers.html#ch_zkDataModel).
ModelSyncPollInterval	100	Fréquence de synchronisation du modèle entre les serveurs du cluster. La valeur est exprimée en millisecondes.
ModelSyncWaitPeriod	3000	Lors de la communication via des WebSockets, le trafic est routé de manière cyclique sur plusieurs serveurs. Si une modification du modèle est effectuée via des WebSockets, la demande suivante attendra que la durée spécifiée en millisecondes passe pour que le modèle soit synchronisé sur le serveur sur lequel il se trouve. Si aucune synchronisation ne se produit avant le délai d'inactivité, la requête échoue avec une erreur de délai d'inactivité.
ModelSyncTimeout	120000	Délai d'attente (en millisecondes) pour chaque nouvelle tentative.
CoordinatorMaxRetries	3	En cas d'échec de communication avec le coordinateur, le système effectue n nouvelles tentatives avant d'échouer.
CoordinatorSessionTimeout	90000	Délai d'attente par ThingWorx (en millisecondes) d'une pulsation du service Apache ZooKeeper utilisé pour coordonner la priorité de ThingWorx.
CoordinatorConnectionTimeout	10000	Durée (en millisecondes) pendant laquelle le système attend une connexion au coordinateur.
MetricsCacheFrequency	60000	Les mesures sont suivies par serveur et agrégées pour les mesures de niveau de cluster. Cette valeur correspond à la fréquence (en millisecondes) de mise à jour des mesures du cluster.

Paramètres utilisateur administrateur

Paramètre	Par défaut	Description
InitialPassword	n/a	Mot de passe administrateur initial requis pour se connecter à ThingWorx pour la première fois. La longueur minimale peut être configurée dans le sous-système de gestion des utilisateurs (10 caractères minimum, la valeur par défaut est de 14 caractères). Consultez pour en savoir plus.

Paramètres de type de contenu

Paramètre

Par défaut

Description

supportedMediaEntityContentTypes

"image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"

Liste des types de contenu MIME valides, séparés par une virgule, qui peuvent être liés dynamiquement aux entités de média. Des types supplémentaires peuvent être ajoutés.

Si le type de contenu provenant d'un serveur différent n'est pas un type d'entité de média pris en charge, le contenu est téléchargé sous la forme d'un fichier sur l'ordinateur client au lieu d'être diffusé avec l'entité de média.

Paramètres de connexion pour la licence

Paramètre

Par défaut

Description

username

n/a

Nom d'utilisateur du site de support PTC.

password

n/a

Mot de passe du site de support PTC.

timeout (en secondes)

Une fois le délai d'inactivité dépassé, le message d'erreur suivant est consigné dans le journal de l'application :

License Server could not process request

useProxy

faux

Active les paramètres de proxy pour la gestion des licences. Si la valeur est définie sur "vrai", les paramètres de proxy sont utilisés pour la connexion au serveur de licence.

proxyHost

Nom de l'hôte proxy.

proxyPort

Numéro de port de l'hôte proxy.

proxyScheme

http

http ou https.

proxyUsername

Nom d'utilisateur aux fins de l'authentification si la connexion au serveur proxy requiert une authentification.

proxyPassword

Mot de passe aux fins de l'authentification si la connexion au serveur proxy requiert une authentification.

Pour plus d'informations sur le chiffrement de cette valeur, consultez la section Chiffrement de mots de passe.

proxyUseNTLM

faux

Option permettant d'utiliser le protocole NTLM.

proxyWorkstation

Nom de l'ordinateur de l'utilisateur sur le réseau, si l'authentification NTLM est requise.

proxyDomain

Nom du domaine de l'utilisateur, si l'authentification NTLM est requise.

Paramètres de l'utilisateur Mesures

Paramètre	Par défaut	Description
InitialPassword		Crée le MetricsUser lors du démarrage du système et est utilisé par le serveur Prometheus pour extraire les informations de mesure d'une instance ThingWorx. Ce paramètre doit être défini pour tous les déploiements MSAI, mais il est facultatif pour tous les autres types de déploiements.

Paramètres de fournisseur de persistance

Pour toutes les bases de données répertoriées ci-dessous, les instructions suivantes doivent être respectées pour les paramètres du processeur de flux de valeurs et les paramètres du processeur de flux :

StreamProcessorSettings.numberOfProcessingThreads + ValueStreamProcessorSettings.numberOfProcessingThreads < 50% of DB connection pool
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads

H2PersistenceProviderPackage

Paramètre

Par défaut

Description

Informations de connexion

acquireIncrement

Détermine le nombre de connexions simultanées que ThingWorx tentera d'acquérir lorsque le pool est épuisé.

acquireRetryAttempts

Définit le nombre maximal de tentatives de ThingWorx pour acquérir une nouvelle connexion à partir de la base de données.

acquireRetryDelay

1000

Délai (en millisecondes) attendu par ThingWorx entre chaque tentative.

checkoutTimeout

1000000

Délai en millisecondes attendu par un client appelant getConnection() pour récupérer ou obtenir une connexion lorsque le pool est épuisé.

Network Timeout

900000

Délai (en millisecondes) pendant lequel un thread attend la réponse de la base de données.

En l'absence de réponse dans le délai défini avec ce paramètre, la plateforme mettra fin à la connexion sous-jacente et libérera le thread en attente de réponse.

idleConnectionTestPeriod

Période de temps (en secondes) pendant laquelle les connexions seront testées afin que les connexions inactives ne soient pas fermées par des processus externes, notamment les pare-feu. Si la valeur est supérieure à 0, ThingWorx testera toutes les x secondes les connexions inactives, dans le pool, mais non utilisées.

Si vous rencontrez des erreurs vous indiquant qu'aucune connexion n'est établie avec le fournisseur de modèles, vérifiez ce paramètre. Comparez-le avec les paramètres par défaut du pare-feu. Diminuer la valeur par défaut limitera les problèmes de déconnexion.

initialPoolSize

Nombre initial de connexions de base de données créées et conservées dans un pool au démarrage. Ce paramètre doit être compris entre minPoolSize et maxPoolSize.

maxConnectionAge

Durée de vie en secondes. Une connexion dont l'ancienneté est supérieure à la valeur de maxConnectionAge sera détruite et purgée du pool.

maxIdleTime

Nombre de secondes pendant lesquelles une connexion non utilisée peut rester dans le pool avant d'être supprimée. Une valeur de zéro signifie que les connexions inactives n'expireront jamais.

maxIdleTimeExcessConnections

36000

Délai en secondes pendant lequel les connexions en trop de minPoolSize sont autorisées à rester inactives dans le pool avant d'être détruites. Destiné aux applications qui souhaitent réduire considérablement le nombre de connexions ouvertes, en limitant le pool selon la valeur de minPoolSize si, après une pointe, le niveau de charge diminue et les connexions acquises ne sont plus nécessaires. Si maxIdleTime est défini, maxIdleTimeExcessConnections doit être inférieur pour être actif. Une valeur de zéro signifie qu'aucun délai n'est défini et que les connexions en trop ne seront pas désactivées.

maxPoolSize

100

Nombre maximal de connexions qu'un pool maintient à tout moment.

maxStatements

Taille du cache PreparedStatement global de ThingWorx.

maxStatementsPerConnection

Taille du cache PreparedStatement global ThingWorx pour chaque connexion.

minPoolSize

Nombre minimal de connexions qu'un pool maintient à tout moment.

numHelperThreads

Nombre de threads d'assistance à générer. Les opérations JDBC lentes sont généralement effectuées par des threads d'assistance qui ne disposent pas de verrouillage pour la contention. Le fait de répartir ces opérations sur plusieurs threads peut considérablement améliorer les performances, plusieurs opérations étant effectuées en même temps.

password

n/a

Mot de passe de la base de données.

username

twadmin

Nom d'utilisateur de la base de données.

tableLockTimeout

10000

Nombre de millisecondes attendues par un client pour le déverrouillage d'une table de base de données.

testConnectionOnCheckout

false

Si ce paramètre est défini sur Vrai, une opération sera exécutée à chaque récupération de connexion pour vérifier la validité de cette dernière.

unreturnedConnectionTimeout

Nombre de secondes attendues pour obtenir une réponse d'une connexion ne répondant pas avant de la supprimer. Si ce paramètre est défini, lorsqu'une application récupère une connexion, mais ne parvient pas à s'y connecter dans la période de temps spécifiée, le pool détruit la connexion. Cela permet aux applications subissant occasionnellement des pertes de connexion de persister, au lieu d'épuiser le pool de connexions. Une valeur de zéro signifie qu'aucun délai n'est défini et les applications sont tenues de fermer leurs propres connexions.

StreamProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

Dans le cas où la file d'attente est complète et n'a pas de place pour une nouvelle entrée, ce paramètre correspond au délai maximal (en millisecondes) attendu par un producteur pour ajouter l'entrée à la file d'attente. Une fois ce délai écoulé, si la file d'attente est toujours complète et qu'il n'est pas possible de faire de la place, l'ajout de l'entrée à la file d'attente échoue.

ValueStreamProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

PersistentPropertyProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de propriétés à traiter dans un bloc.

maximumWaitTime

1000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de propriété.

maximumQueueSize

100000

Nombre maximal d'entrées de propriété à mettre en file d'attente (les suivantes seront rejetées).

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de propriété.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

PostgresPersistenceProviderPackage

Paramètre

Par défaut

Description

ConnectionInformation

acquireIncrement

Détermine le nombre de connexions simultanées que la plateforme tentera d'acquérir lorsque le pool est épuisé.

acquireRetryAttempts

Définit le nombre maximal de tentatives de ThingWorx pour acquérir une nouvelle connexion à partir de la base de données.

acquireRetryDelay

10000

Délai (en millisecondes) attendu par ThingWorx entre chaque tentative.

checkoutTimeout

10000000

Délai en millisecondes attendu par un client appelant getConnection() pour récupérer ou obtenir une connexion lorsque le pool est épuisé.

Query Timeout

600000

Délai (en millisecondes) dont une requête dispose pour aboutir avant d'être annulée.

Network Timeout

900000

Délai (en millisecondes) pendant lequel un thread attend la réponse de la base de données.

En l'absence de réponse dans le délai défini avec ce paramètre, la plateforme mettra fin à la connexion sous-jacente et libérera le thread en attente de réponse.

driverClass

org.postgresql.Driver

Nom de classe complet du paramètre driverClass JDBC censé fournir des connexions.

fetchSize

5000

Nombre de lignes à extraire par lots au lieu de mettre en cache toutes les lignes côté client.

idleConnectionTestPeriod

Si la valeur est supérieure à 0, ThingWorx testera toutes les x secondes les connexions inactives, dans le pool, mais non utilisées.

initialPoolSize

Nombre initial de connexions de base de données créées et conservées dans un pool au démarrage. Ce paramètre doit être compris entre minPoolSize et maxPoolSize.

jdbcUrl

jdbc:postgresql://localhost:5432/thingworx

URL JDBC utilisée pour la connexion à PostgreSQL.

Si le nom de schéma par défaut (public) est modifié, vous devez ajouter <nom de la base de données>?currentSchema=<nom du schéma>. Par exemple, si le nom de schéma est mySchema, la valeur serait la suivante : jdbc:postgresql://<DBServer>:<DBPort>/<databasename>?currentSchema=mySchema

Si vous configurez une solution haute disponibilité, cette valeur doit correspondre à l'adresse IP du serveur sur lequel le processus pgPool est exécuté. Remplacez le port par celui que pgPool sert.

maxConnectionAge

Durée de vie en secondes. Une connexion dont l'ancienneté est supérieure à la valeur de maxConnectionAge sera détruite et purgée du pool.

maxIdleTime

Nombre de secondes pendant lesquelles une connexion non utilisée peut rester dans le pool avant d'être supprimée. Une valeur de zéro signifie que les connexions inactives n'expireront jamais.

maxIdleTimeExcessConnections

300

maxPoolSize

100

Nombre maximal de connexions qu'un pool maintient à tout moment.

maxStatements

100

Taille du cache PreparedStatement global de ThingWorx.

minPoolSize

Nombre minimal de connexions qu'un pool maintient à tout moment.

numHelperThreads

password

Mot de passe utilisé pour se connecter à la base de données.

testConnectionOnCheckout

false

Si ce paramètre est défini sur Vrai, une opération sera exécutée à chaque récupération de connexion pour vérifier la validité de cette dernière.

unreturnedConnectionTimeout

username

twadmin

Utilisateur disposant du privilège de modification des tables. Il s'agit de l'utilisateur créé dans la base de données du serveur ThingWorx.

Pour modifier le mot de passe PostgreSQL : modifiez le mot de passe de cet utilisateur et également le paramètre de mot de passe non chiffré dans le fichier platform-settings.json ou la valeur chiffrée dans le keystore /ThingworxStorage/keystore.jks.

Paramètres du processeur de flux

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads de traitement.

scanRate

Le statut du tampon est vérifié selon la fréquence définie en millisecondes.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

Paramètres du processeur de flux de valeurs

maximumBlockSize

2500

Nombre maximal d'écritures de flux de valeurs à traiter dans un bloc.

maximumQueueSize

500000

Nombre maximal d'entrées de flux de valeurs à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux de valeurs.

numberofProcessingThreads

Nombre de threads de traitement.

scanRate

Fréquence d'analyse (en millisecondes) avant le vidage du tampon de flux.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux de valeurs.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

PersistentPropertyProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de propriétés à traiter dans un bloc.

maximumWaitTime

1000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de propriété.

maximumQueueSize

100000

Nombre maximal d'entrées de propriété à mettre en file d'attente (les suivantes seront rejetées).

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de propriété.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

MssqlPersistenceProviderPackage

Paramètre

Par défaut

Description

ConnectionInformation

acquireIncrement

Détermine le nombre de connexions simultanées que ThingWorx tentera d'acquérir lorsque le pool est épuisé.

acquireRetryAttempts

Définit le nombre maximal de tentatives de ThingWorx pour acquérir une nouvelle connexion à partir de la base de données.

acquireRetryDelay

10000

Délai (en millisecondes) attendu par ThingWorx entre chaque tentative.

checkoutTimeout

1000000

Délai en millisecondes attendu par un client appelant getConnection() pour récupérer ou obtenir une connexion lorsque le pool est épuisé.

driverClass

com.microsoft.sqlserver.jdbc.SQLServerDriver

Nom de classe complet du paramètre driverClass JDBC censé fournir des connexions.

fetchSize

5000

Nombre de lignes à extraire par lots au lieu de mettre en cache toutes les lignes côté client.

idleConnectionTestPeriod

initialPoolSize

Nombre initial de connexions de base de données créées et conservées dans un pool au démarrage. Ce paramètre doit être compris entre minPoolSize et maxPoolSize.

jdbcUrl

jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx;

URL JDBC utilisée pour la connexion à MSSQL.

maxConnectionAge

Durée de vie en secondes. Une connexion dont l'ancienneté est supérieure à la valeur de maxConnectionAge sera détruite et purgée du pool.

maxIdleTime

Nombre de secondes pendant lesquelles une connexion non utilisée peut rester dans le pool avant d'être supprimée. Une valeur de zéro signifie que les connexions inactives n'expireront jamais.

maxIdleTimeExcessConnections

300

maxPoolSize

100

Nombre maximal de connexions qu'un pool maintient à tout moment.

maxStatements

100

Taille du cache PreparedStatement global de ThingWorx.

minPoolSize

Nombre minimal de connexions qu'un pool maintient à tout moment.

numHelperThreads

password

Mot de passe utilisé pour se connecter à la base de données.

testConnectionOnCheckout

false

Si ce paramètre est défini sur Vrai, une opération sera exécutée à chaque récupération de connexion pour vérifier la validité de cette dernière.

unreturnedConnectionTimeout

username

msadmin

Il s'agit de l'ID utilisateur qui possède le schéma TWSCHEMA et est utilisé pour l'authentification à MSSQL dans la chaîne de connexion JDBC.

Query Timeout

600000

Délai (en millisecondes) dont une requête dispose pour aboutir avant d'être annulée.

Network Timeout

900000

Délai (en millisecondes) pendant lequel un thread attend la réponse de la base de données.

En l'absence de réponse dans le délai défini avec ce paramètre, la plateforme mettra fin à la connexion sous-jacente et libérera le thread en attente de réponse.

Paramètres du processeur de flux

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads de traitement.

scanRate

Le statut du tampon est vérifié selon la fréquence définie en millisecondes.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

Paramètres du processeur de flux de valeurs

maximumBlockSize

2500

Nombre maximal d'écritures de flux de valeurs à traiter dans un bloc.

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux de valeurs.

maximumQueueSize

500000

Nombre maximal d'entrées de flux de valeurs à mettre en file d'attente (les suivantes seront rejetées).

numberofProcessingThreads

Nombre de threads de traitement.

scanRate

Fréquence d'analyse (en millisecondes) avant le vidage du tampon de flux.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux de valeurs.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

PersistentPropertyProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de propriétés à traiter dans un bloc.

maximumWaitTime

1000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de propriété.

maximumQueueSize

100000

Nombre maximal d'entrées de propriété à mettre en file d'attente (les suivantes seront rejetées).

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de propriété.

Producer Timeout

3000

Ce paramètre s'applique aux processeurs d'entrées de flux et, pour l'heure, s'applique uniquement au processeur de propriétés persistantes.

Paramètres de cache

Les paramètres de cache ne sont requis que lors de l'exécution de ThingWorx Platform en mode cluster.

Si vous exécutez le mode serveur unique, excluez les paramètres de cache de la configuration. S'ils sont inclus en mode serveur unique, ils exécutent le mode de mise en cache distribué à l'aide d'Apache Ignite, qui est moins performant que l'exécution de la mise en cache de mémoire locale par défaut.

Paramètre	Par défaut	Description
provider-type	[Le fournisseur de cache pour l'exécution en mode serveur unique.]	En mode cluster, la valeur doit toujours être définie sur com.thingworx.cache.ignite.IgniteCacheProvider.
instance-name	Aucune	Définit le nom de l'instance locale du cache.
client-mode	vrai	Détermine si la base de données Ignite intégrée s'exécute sous la forme d'un client (par défaut) ou d'un serveur. En mode serveur, il participe au stockage des données et utilise plus de mémoire.
address-resolver type	static	Détermine comment d'autres noeuds Ignite seront découverts. Le paramètre recommandé est zookeeper.
connection	Aucune	Pour un address-resolver type dont la valeur est zookeeper, une liste séparée par une virgule des serveurs Apache Zookeeper utilisés pour coordonner l'élection d'un noeud leader ThingWorx. Le format de la chaîne est le suivant : IP:port (par exemple, 127.0.0.1:2181, 127.0.0.2:2181).
endpoints	Aucune	Pour un address-resolver type dont la valeur est static, un tableau d'adresses statiques où Ignite est en cours d'exécution.

Ajout d'une section d'événement audité à platform-settings.json

Au redémarrage de ThingWorx Platform, tous les objets déclenchent l'événement ThingStart. L'audit de tous ces événements augmente le temps de démarrage de la plateforme. Pour éviter cette situation, l'événement ThingStart est désactivé par défaut. Si vous souhaitez toujours auditer cette action, il est possible d'activer et de désactiver les événements dans le fichier platform-settings.json.

Le fichier platform-settings.json ne contient pas de section pour l'audit. Pour activer ou désactiver des catégories et des messages, vous devez ajouter une structure JSON au fichier. Pour l'instance ThingWorx Platform pour laquelle vous souhaitez des messages d'audit, vous devez être administrateur avec les permissions nécessaires pour rechercher et modifier le fichier platform-settins.json et ajouter la configuration appropriée.

La section Audit doit être ajoutée en tant que noeud frère à l'entrée JSON de PlatformSettingsConfig. Il peut être situé avant ou après le noeud PlatformSettingsConfig, mais il doit se situer au même niveau de noeud.

Voici un exemple de structure d'audit placée après le noeud PlatformSettingsConfig dans le fichier platform-settings.json :

"PlatformSettingsConfig:: {
"BasicSettings":( . . .
}
}
"Audit": {
"Disabled": [{
"CategoryKey": "audit.AuditCategory.Collaboration",
"MessageKeys": ["ALL"]
}, {
"CategoryKey": "audit.AuditCategory.Authentication",
"MessageKeys": [
"com.thingworx.things.security.SecurityMonitorThing.LoginSucceeded.Audit",
"com.thingworx.things.security.SecurityMonitorThing.ApplicationKeyFailed.Audit"
]
}
],
"Enabled": [{
"CategoryKey": "audit.AuditCategory.RemoteAccess",
"MessageKeys": ["ALL"]
}, {
"CategoryKey": "audit.AuditCategory.Authentication",
"MessageKeys": [
"thingworx.things.security.SecurityMonitorThing.LoginFailed.Audit" ]
], {
"CategoryKey": "audit.AuditCategory.ThingGroupMemberships",
"MessageKeys": [
"com.thingworx.thinggroups.ThingGroup.AddedThingAsChildMember",
"com.thingworx.thinggroups.ThingGroup.DeletedThingAsChildMember",
"com.thingworx.thinggroups.ThingGroup.AddedThingGroupAsChildMember",
"com.thingworx.thinggroups.ThingGroup.DeletedThingGroupAsChildMember",
"com.thingworx.thinggroups.ThingGroup.DeletedAllChildMembers"
]
}
]
}

Dans cet exemple, la catégorie COLLABORATION et ["ALL"] (tous) ses événements/messages sont désactivés. Pour la catégorie AUTHENTICATION, deux événements/messages sont désactivés : LoginSucceeded et ApplicationKeyFailed. La catégorie REMOTE_ACCESS et ["ALL"] (tous) ses événements/messages sont activés. Pour la catégorie AUTHENTICATION, l'événement/message LoginFailed est activé. Pour THINGGROUPMEMBERSHIPs, tous les messages d'audit sont activés. Au lieu d'utiliser ["ALL"], ces messages sont répertoriés séparément. Vous pouvez choisir cette méthode de consignation des messages d'audit afin de déterminer, après une longue exécution de l'instance de plateforme, s'ils sont tous nécessaires.

La catégorie audit.AuditCategory.ThingGroupMemberships fournit des messages d'audit concernant les modifications liées à l'appartenance d'un groupe d'objets. Cette catégorie de messages d'audit est désactivée par défaut, car certain(e)s configurations/déploiements n'ont pas besoin de ces messages d'audit et les administrateurs système ne souhaitent pas subir l'impact de ces modifications en termes de calcul et de persistance. Si vos configurations/déploiements nécessitent des messages d'audit pour les modifications liées à l'appartenance d'un groupe d'objets, vous pouvez les activer, comme illustré dans l'exemple ci-dessus. Chaque message d'audit peut être activé ou désactivé séparément, ce qui évite d'en activer ou désactiver d'autres. Vous souhaiterez peut-être n'auditer que des modifications d'appartenance précises, par exemple. Les messages d'audit liés à l'appartenance d'un groupe d'objets sont répertoriés dans la table Tableau 122 de la rubrique Messages d'audit de ThingWorx de ce Centre d'aide.

Les messages d'audit pour les deux types de messages suivants sont toujours activés et ne nécessitent pas d'activation explicite. Ils fournissent des messages d'audit lorsque la fonction de délégation des permissions de visibilité des groupes d'objets est activée ou désactivée :

com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled
com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled

Pour activer ou désactiver une catégorie et un message d'audit, vous pouvez copier la structure indiquée ci-dessus et ajouter les clés appropriées aux groupes "Disabled" et/ou "Enabled". Pour obtenir des instructions détaillées, reportez-vous à la rubrique Activation et désactivation des événements d'audit. Pour trouver les clés appropriées pour les catégories et les messages d'événement, reportez-vous à la table Tableau 122 dans la rubrique Messages d'audit de ThingWorx dans ce Centre d'aide.

Est-ce que cela a été utile ?