### Example OneAgent Installer URL (v1.39.1000+)

Source: https://docs.dynatrace.com/managed/ingest-from/amazon-web-services/integrate-into-aws/aws-beanstalk

This is an example of the OneAgent installer URL for Linux, used to download the agent. Replace `<arch>` with the appropriate architecture.

```bash
https://host.domain.com/api/v1/deployment/installer/agent/unix/default/latest?arch=<arch>
```

--------------------------------

### Example OneAgent Installer URL with API Token

Source: https://docs.dynatrace.com/managed/ingest-from/amazon-web-services/integrate-into-aws/aws-beanstalk

This example shows how to append the API token to the OneAgent installer URL. Ensure you use a PaaS token for the `Api-Token` parameter.

```bash
https://host.domain.com/api/v1/deployment/installer/agent/unix/default/latest?arch=x86&flavor=default&Api-Token=<token>
```

--------------------------------

### Example OneAgent Installer URL

Source: https://docs.dynatrace.com/managed/ingest-from/setup-on-container-platforms/docker/set-up-dynatrace-oneagent-as-docker-container

This is an example of the OneAgent installer URL format for Docker image versions 1.39.1000 and later. Ensure you replace `<arch>` with the appropriate architecture.

```text
https://host.domain.com/api/v1/deployment/installer/agent/unix/default/latest?arch=<arch>
```

--------------------------------

### Example OneAgent Installer URL with API Token

Source: https://docs.dynatrace.com/managed/ingest-from/setup-on-container-platforms/docker/set-up-dynatrace-oneagent-as-docker-container

This example shows the OneAgent installer URL with the API token appended, using the `Api-Token` parameter. This format is required for OneAgent container image versions 1.39.1000 and later.

```text
https://host.domain.com/api/v1/deployment/installer/agent/unix/default/latest?arch=x86&flavor=default&Api-Token=<token>
```

--------------------------------

### Optional OneAgent Installer Parameters

Source: https://docs.dynatrace.com/managed/ingest-from/amazon-web-services/integrate-into-aws/aws-ecs

Example of setting optional OneAgent installer parameters via environment variables. Customize monitoring mode, log access, and network zones as needed.

```bash
--set-monitoring-mode=infra-only --set-app-log-content-access=false --set-network-zone=<your.network.zone>
```

--------------------------------

### List Available Command Line Options

Source: https://docs.dynatrace.com/managed/managed-cluster/installation/customize-managed-cluster-install

Run the installer with the --help parameter to list all available command line options for customization.

```bash
#!/bin/bash
./dynatrace-managed-installer.sh --help
```

--------------------------------

### Get License Consumption for a Specific Hour

Source: https://docs.dynatrace.com/managed/dynatrace-api/cluster-api/cluster-api-v2/export-license-data/get-export-license-data-hour

This example demonstrates how to retrieve license consumption data for a specific hour using the Dynatrace Cluster API. You need to provide the start timestamp in milliseconds since the epoch.

```APIDOC
## GET /api/cluster/v2/license/consumption/hour

### Description
Retrieves license consumption data for a specific hour.

### Method
GET

### Endpoint
/api/cluster/v2/license/consumption/hour

### Query Parameters
- **startTs** (integer) - Required - The start timestamp in milliseconds since the epoch for which to retrieve license data.

### Request Example
```bash
curl -X GET "https://myManaged.cluster.com/api/cluster/v2/license/consumption/hour?startTs=1641808800000" \
     -H "accept: application/json; charset=utf-8" \
     -H "Authorization: Api-Token abcdefjhij1234567890"
```

### Response
#### Success Response (200)
- **clusterUuid** (string) - The unique identifier of the cluster.
- **timeFrameStart** (integer) - The start timestamp of the data retrieval period in milliseconds.
- **timeFrameEnd** (integer) - The end timestamp of the data retrieval period in milliseconds.
- **environmentBillingEntries** (array) - A list of billing entries for each environment.
  - **environmentUuid** (string) - The unique identifier of the environment.
  - **visits** (integer) - The number of visits recorded.
  - **mobileSessions** (integer) - The number of mobile sessions recorded.
  - **totalRUMUserPropertiesUsed** (integer) - The total number of RUM user properties used.
  - **newProblems** (integer) - The number of new problems detected.
  - **hostUsages** (array) - A list of host usage details.
    - **osiId** (integer) - The OS identifier for the host.
    - **hostName** (string) - The name of the host.
    - **hostCategory** (string) - The category of the host.
    - **agentUsages** (array) - A list of agent usage details for the host.
      - **networkTraffic** (integer) - The network traffic consumed by the agent.
      - **agentId** (integer) - The unique identifier of the agent.
      - **agentTypeId** (integer) - The type identifier of the agent.
      - **agentUsageRecords** (array) - A list of agent usage records.
        - **startTime** (integer) - The start time of the agent usage record in milliseconds.
        - **endTime** (integer) - The end time of the agent usage record in milliseconds.
    - **infrastructureOnly** (boolean) - Indicates if the host is infrastructure-only.
    - **paas** (boolean) - Indicates if the host is a platform-as-a-service.
    - **passMemoryLimit** (integer) - The memory limit for the host.
    - **vendorTypeId** (integer) - The vendor type identifier for the host.
    - **hostMemoryBytes** (integer) - The amount of host memory in bytes.
    - **premiumLogAnalytics** (boolean) - Indicates if premium log analytics is enabled for the host.
    - **hasContainers** (boolean) - Indicates if the host has containers.
  - **downloads** (array) - A list of download details.
    - **downloadCount** (integer) - The number of downloads.
    - **firstDownloadTime** (string) - The timestamp of the first download.
    - **type** (string) - The type of download.
    - **version** (string) - The version of the downloaded item.
  - **syntheticUsages** (array) - A list of synthetic usage details.
    - **failureCount** (integer) - The number of failed synthetic tests.
    - **monitorDefinitionId** (string) - The ID of the synthetic monitor definition.
    - **monitorDescription** (string) - The description of the synthetic monitor.
    - **monitorTypeId** (integer) - The type ID of the synthetic monitor.
    - **performedSyntheticActions** (integer) - The number of synthetic actions performed.
    - **successCount** (integer) - The number of successful synthetic tests.
    - **syntheticActionCount** (integer) - The total number of synthetic actions.
  - **syntheticBillingUsage** (array) - A list of synthetic billing usage details.
    - **monitorTypeId** (integer) - The type ID of the synthetic monitor.
    - **privateExecutions** (integer) - The number of private synthetic executions.
    - **publicExecutions** (integer) - The number of public synthetic executions.
    - **testId** (integer) - The ID of the synthetic test.
  - **customMetrics** (array) - A list of custom metric usage details.
    - **source** (string) - The source of the custom metric.
    - **total** (integer) - The total count of the custom metric.
  - **davisDataUnits** (array) - A list of Davis data units consumed.
    - **pool** (string) - The pool name for the Davis data unit.
    - **total** (integer) - The total amount of Davis data units.
  - **trial** (boolean) - Indicates if the environment is in a trial period.
  - **internalUse** (boolean) - Indicates if the environment is for internal use.
  - **highAvailabilityCluster** (boolean) - Indicates if the cluster is highly available.
  - **logStorageUsageBytes** (integer) - The amount of log storage used in bytes.
  - **logUploadVolumeBytes** (integer) - The volume of log uploads in bytes.
  - **sessionReplays** (integer) - The number of session replays.
  - **mobileSessionReplays** (integer) - The number of mobile session replays.

#### Response Example
```json
{
  "clusterUuid": "02ed02ed-02ed-02ed-02ed-02ed02ed02ed",
  "timeFrameStart": 1641808800000,
  "timeFrameEnd": 1641812400000,
  "environmentBillingEntries": [
    {
      "environmentUuid": "590939093-9093-9093-9093-909390903909",
      "visits": 323,
      "mobileSessions": 101,
      "totalRUMUserPropertiesUsed": 10,
      "newProblems": 0,
      "hostUsages": [
        {
          "osiId": -5174977934749450000,
          "hostName": null,
          "hostCategory": "L",
          "agentUsages": [
            {
              "networkTraffic": null,
              "agentId": 2000000008,
              "agentTypeId": 1,
              "agentUsageRecords": [
                {
                  "startTime": 1641808800000,
                  "endTime": 1641812400000
                }
              ]
            }
          ],
          "infrastructureOnly": false,
          "paas": false,
          "passMemoryLimit": 0,
          "vendorTypeId": null,
          "hostMemoryBytes": 8538218496,
          "premiumLogAnalytics": true,
          "hasContainers": false
        }
      ],
      "downloads": [],
      "syntheticUsages": [],
      "syntheticBillingUsage": [],
      "customMetrics": null,
      "davisDataUnits": [
        {
          "pool": "Metrics",
          "total": 31
        },
        {
          "pool": "Log",
          "total": 233
        },
        {
          "pool": "Events",
          "total": 123
        },
        {
          "pool": "Traces",
          "total": 15.46369
        },
        {
          "pool": "Serverless",
          "total": 4
        }
      ],
      "trial": false,
      "internalUse": false,
      "highAvailabilityCluster": false,
      "logStorageUsageBytes": 0,
      "logUploadVolumeBytes": 0,
      "sessionReplays": 3123,
      "mobileSessionReplays": 1232
    }
  ]
}
```

#### Response code
`200`
```

--------------------------------

### Show General Help (Example)

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-activegate/agctl-command-line-interface

Example of how to display general help for the agctl CLI.

```bash
# Show general help
agctl help
```

--------------------------------

### Command Line Matching Examples

Source: https://docs.dynatrace.com/managed/observe/infrastructure-observability/process-groups/configuration/unified-process-grouping/process-grouping-rules-configure

Demonstrates how 'Command line' and 'Command line - single argument' properties match different parts of a process's command line.

```text
myProgram.exe --instance=10 --port=9090 --arg=32
```

```text
$contains(--port=9090)
```

```text
$suffix(=32)
```

```text
$prefix(my)
```

```text
$eq(myProgramm.exe --instance=10 --port=9090 --arg=32)
```

```text
$contains(--port=9090)
```

```text
$suffix(exe)
```

```text
$suffix(=10)
```

```text
$suffix(9090)
```

```text
$suffix(arg=32)
```

```text
$prefix(my)
```

```text
$prefix(--instance)
```

```text
$prefix(--p)
```

```text
$prefix(--arg=)
```

```text
$eq(myProgramm.exe)
```

```text
$eq(--instance=10)
```

```text
$eq(--port=9090)
```

```text
$eq(--arg=32)
```

--------------------------------

### Install OneAgent on Ubuntu Server

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-oneagent/installation-and-operation/linux/installation/install-oneagent-on-linux

Use this command to install OneAgent on Ubuntu Server. Requires root access to start the installation.

```bash
sudo /bin/sh Dynatrace-OneAgent-Linux-1.0.0.sh
```

--------------------------------

### NOT startsWith Condition Example

Source: https://docs.dynatrace.com/managed/manage/identity-access-management/permission-management/manage-user-permissions-policies/iam-policystatement-syntax

Example of using the NOT startsWith operator to check if an attribute does not start with a specific prefix.

```plaintext
WHERE storage:table-name NOT startsWith "application."
```

--------------------------------

### Display Installer Help

Source: https://docs.dynatrace.com/managed/managed-cluster/installation/install-managed-cluster

View a list of all available installation parameters for the Dynatrace Managed installer.

```bash
--help
```

--------------------------------

### Create Environment

Source: https://docs.dynatrace.com/managed/dynatrace-api/cluster-api/cluster-api-v2/environments/create-managed-environment

This example demonstrates how to create a new managed environment with specified configurations for quotas, storage, and tags. It also shows how to request a token management token upon creation.

```APIDOC
## POST /api/cluster/v2/environments

### Description
Creates a new managed environment with specified configurations for quotas, storage, and tags. Optionally generates a token management token.

### Method
POST

### Endpoint
/api/cluster/v2/environments?createToken=true

### Request Body
- **name** (string) - Required - The name of the environment.
- **state** (string) - Required - The initial state of the environment (e.g., ENABLED).
- **tags** (array of strings) - Optional - Tags to associate with the environment.
- **trial** (boolean) - Optional - Whether the environment is a trial environment.
- **quotas** (object) - Optional - Quota configurations for the environment.
  - **hostUnits** (object) - Optional - Host unit quota.
    - **maxLimit** (number) - Optional - Maximum limit for host units.
  - **demUnits** (object) - Optional - DEM units quota.
    - **monthlyLimit** (number) - Optional - Monthly limit for DEM units.
    - **annualLimit** (number) - Optional - Annual limit for DEM units.
  - **userSessions** (object) - Optional - User session quota.
    - **totalMonthlyLimit** (number) - Optional - Total monthly limit for user sessions.
    - **totalAnnualLimit** (number) - Optional - Total annual limit for user sessions.
  - **syntheticMonitors** (object) - Optional - Synthetic monitor quota.
    - **monthlyLimit** (number) - Optional - Monthly limit for synthetic monitors.
    - **annualLimit** (number) - Optional - Annual limit for synthetic monitors.
  - **davisDataUnits** (object) - Optional - Davis data units quota.
    - **monthlyLimit** (number) - Optional - Monthly limit for Davis data units.
    - **annualLimit** (number) - Optional - Annual limit for Davis data units.
- **storage** (object) - Optional - Storage configurations for the environment.
  - **transactionStorage** (object) - Optional - Transaction storage configuration.
    - **maxLimit** (number) - Optional - Maximum limit for transaction storage in MB.
  - **sessionReplayStorage** (object) - Optional - Session replay storage configuration.
    - **maxLimit** (number) - Optional - Maximum limit for session replay storage in MB.
  - **symbolFilesFromMobileApps** (object) - Optional - Symbol files from mobile apps storage configuration.
    - **maxLimit** (number) - Optional - Maximum limit for symbol files storage in MB.
  - **serviceRequestLevelRetention** (object) - Optional - Service request level data retention.
    - **maxLimitInDays** (number) - Optional - Maximum retention period in days.
  - **serviceCodeLevelRetention** (object) - Optional - Service code level data retention.
    - **maxLimitInDays** (number) - Optional - Maximum retention period in days.
  - **realUserMonitoringRetention** (object) - Optional - Real user monitoring data retention.
    - **maxLimitInDays** (number) - Optional - Maximum retention period in days.
  - **syntheticMonitoringRetention** (object) - Optional - Synthetic monitoring data retention.
    - **maxLimitInDays** (number) - Optional - Maximum retention period in days.
  - **sessionReplayRetention** (object) - Optional - Session replay data retention.
    - **maxLimitInDays** (number) - Optional - Maximum retention period in days.
  - **userActionsPerMinute** (object) - Optional - User actions per minute configuration.
    - **maxLimit** (number) - Optional - Maximum limit for user actions per minute.
  - **transactionTrafficQuota** (object) - Optional - Transaction traffic quota.
    - **maxLimit** (number) - Optional - Maximum limit for transaction traffic.

### Request Example
```json
{
  "name": "MyNewTeam",
  "state": "ENABLED",
  "tags": [
    "owner:john.wicked@dynatrace.com",
    "department:finance"
  ],
  "trial": false,
  "quotas": {
    "hostUnits": {
      "maxLimit": 1
    },
    "demUnits": {
      "monthlyLimit": 1,
      "annualLimit": 1
    },
    "userSessions": {
      "totalMonthlyLimit": 1,
      "totalAnnualLimit": 2
    },
    "syntheticMonitors": {
      "monthlyLimit": 1,
      "annualLimit": 1
    },
    "davisDataUnits": {
      "monthlyLimit": 1,
      "annualLimit": 2
    }
  },
  "storage": {
    "transactionStorage": {
      "maxLimit": 1024
    },
    "sessionReplayStorage": {
      "maxLimit": 2048
    },
    "symbolFilesFromMobileApps": {
      "maxLimit": 5050
    },
    "serviceRequestLevelRetention": {
      "maxLimitInDays": 35
    },
    "serviceCodeLevelRetention": {
      "maxLimitInDays": 10
    },
    "realUserMonitoringRetention": {
      "maxLimitInDays": 35
    },
    "syntheticMonitoringRetention": {
      "maxLimitInDays": 35
    },
    "sessionReplayRetention": {
      "maxLimitInDays": 35
    },
    "userActionsPerMinute": {
      "maxLimit": 3500
    },
    "transactionTrafficQuota": {
      "maxLimit": 1000
    }
  }
}
```

### Response
#### Success Response (201)
- **id** (string) - The ID of the newly created environment.
- **name** (string) - The name of the environment.
- **tokenManagementToken** (string) - A token with 'Token management' permission, if requested.

#### Response Example
```json
{
  "id": "11a113a1-a11b-1234-123a-4df674c8eb8e",
  "name": "MyNewTeam",
  "tokenManagementToken": "dt0c01.LJMAHMWOKCL5IPH3E2ORNHTR.<token-value>"
}
```
```

--------------------------------

### Start OneAgent with Passed Configuration Dictionary

Source: https://docs.dynatrace.com/managed/observe/digital-experience/mobile-applications/instrument-ios-app/customization/oneagent-sdk-for-ios

Initiate OneAgent startup using the `startupWithConfig` API call with a configuration dictionary. Ensure `kDTXApplicationID` and `kDTXBeaconURL` are provided. Refer to the Dynatrace instrumentation wizard for other required parameters.

```swift
let startupDictionary: [String : Any?] = [
    kDTXApplicationID: "aaaa-bbbb-cccc-dddd-eeee-ffff",
    kDTXBeaconURL: "https://my.beacon.url/mbeacon",
    kDTXLogLevel: "WARNING"
]
Dynatrace.startup(withConfig: startupDictionary)

```

```objc
NSDictionary<NSString*, id> *startupDictionary = @{
    kDTXApplicationID: @"aaaa-bbbb-cccc-dddd-eeee-ffff",
    kDTXBeaconURL: @"https://my.beacon.url/mbeacon",
    kDTXLogLevel: @"WARNING"
};
[Dynatrace startupWithConfig:startupDictionary];

```

--------------------------------

### Install OneAgent on Red Hat Enterprise Linux

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-oneagent/installation-and-operation/linux/installation/install-oneagent-on-linux

Use this command to install OneAgent on Red Hat Enterprise Linux. Requires root access to start the installation.

```bash
su -c '/bin/sh Dynatrace-OneAgent-Linux-1.0.0.sh'
```

--------------------------------

### Show Help for Group Command (Example)

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-activegate/agctl-command-line-interface

Example of how to display help specifically for the 'group' command.

```bash
# Show help for the group command
agctl group help
```

--------------------------------

### Start PurePath distributed trace in COBOL

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-oneagent/installation-and-operation/zos/operation/cics-ims-sdk

COBOL example of calling the DTSP and DTSPTF functions to start a distributed trace.

```COBOL
CALL "DTSP" RETURNING RC.
CALL "DTSPTF" USING FIXED_LEN_STRING, LENGTH, CCSID RETURNING RC.
```

--------------------------------

### Get OneAgent Installation Status

Source: https://docs.dynatrace.com/managed/ingest-from/microsoft-azure-services/azure-integrations/azure-appservice/integrate-oneagent-on-azure-app-service

Retrieves the current status of the OneAgent installation on Azure App Service. It provides details on the installation state, version, and whether an upgrade is available.

```APIDOC
## GET /api/status

### Description
Returns the current status of the OneAgent installation.

### Method
GET

### Endpoint
/api/status

### Response
#### Success Response (200)
- **state** (string) - The current state of the OneAgent installation (e.g., NotInstalled, Downloading, Installing, Installed, Failed).
- **message** (string) - A descriptive message about the installation status.
- **version** (string) - The installed OneAgent version.
- **isAgentInstalled** (boolean) - True if the OneAgent is installed, false otherwise.
- **isUpgradeAvailable** (boolean) - True if an upgrade for OneAgent is available, false otherwise.
- **isFunction** (boolean) - Indicates if a function app is involved.
- **functionAppSettings** (object | null) - Settings related to function apps, if applicable.

#### Response Example
```json
{
    "state": "Installed",
    "message": "OneAgent installed",
    "version": "1.157",
    "isAgentInstalled": true,
    "isUpgradeAvailable": false,
    "isFunction": false,
    "functionAppSettings": null
}
```
```

--------------------------------

### Install IMS with Parameter String

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-oneagent/installation-and-operation/zos/installation/install-ims

Execute the ZDTIINST program with a parameter string to install IMS. Ensure the STEPLIB points to the correct Dynatrace authorization dataset.

```JCL
//S1       EXEC PGM=ZDTIINST,PARM='IMSA,ZDC1,M,,,SEGM=1,IMSB'
//STEPLIB  DD DISP=SHR,DSN=<hlq>.SZDTAUTH
```

--------------------------------

### Example Deployment Manifest File

Source: https://docs.dynatrace.com/managed/deliver/configuration-as-code/monaco/reference/commands

This YAML file defines projects and environments for configuration management.

```yaml
projects:
  - name: infrastructure
    path: infrastructure

environments:
  - group: development
    entries:
      - name: development
        url:
          type: value
          value: "https://mytenant.live.dynatrace.com"
        auth:
          token:
            name: "TestIt"

```

--------------------------------

### Get BOSH Tarball Checksum

Source: https://docs.dynatrace.com/managed/dynatrace-api/environment-api/deployment/bosh/get-bosh-checksum

Gets the checksum of the specified BOSH release tarball. The checksum is the SHA-256 hash of the installer file.

```APIDOC
## GET /e/{your-environment-id}/api/v1/deployment/boshrelease/agent/{osType}/version/{version}/checksum

### Description
Gets the checksum of the specified BOSH release tarball. The checksum is the SHA-256 hash of the installer file.

### Method
GET

### Endpoint
`https://{your-domain}/e/{your-environment-id}/api/v1/deployment/boshrelease/agent/{osType}/version/{version}/checksum`
`https://{your-activegate-domain}/e/{your-environment-id}/api/v1/deployment/boshrelease/agent/{osType}/version/{version}/checksum`

### Parameters
#### Path Parameters
- **osType** (string) - Required - The operating system of the installer. Possible values: `windows`, `unix`.
- **version** (string) - Required - The required version of the OneAgent in the `1.155.275.20181112-084458` format.

#### Query Parameters
- **skipMetadata** (boolean) - Optional - Set `true` to omit the OneAgent connectivity information from the installer. If not set, `false` is used.
- **networkZone** (string) - Optional - The network zone you want the result to be configured with.

### Response
#### Success Response (200)
- **sha256** (string) - The checksum of the BOSH release tarball. This is the sha256 hash of the installer file.

#### Response Example
```json
{
  "sha256": "string"
}
```

#### Error Response (4XX, 5XX)
- **error** (object) - Contains error details.
  - **code** (integer) - The HTTP status code.
  - **constraintViolations** (array) - A list of constraint violations.
    - **location** (string) - -
    - **message** (string) - -
    - **parameterLocation** (string) - The location of the parameter. Possible values: `HEADER`, `PATH`, `PAYLOAD_BODY`, `QUERY`.
    - **path** (string) - -
  - **message** (string) - The error message.

#### Response Example
```json
{
  "error": {
    "code": 1,
    "constraintViolations": [
      {
        "location": "string",
        "message": "string",
        "parameterLocation": "HEADER",
        "path": "string"
      }
    ],
    "message": "string"
  }
}
```
```

--------------------------------

### Start PurePath distributed trace in PL/I

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-oneagent/installation-and-operation/zos/operation/cics-ims-sdk

PL/I example of calling the DTSP, DTSPTN, DTSPTP, and DTSPTF functions to start a distributed trace.

```PL/I
rc = DTSP();
rc = DTSPTN(c_string, ccsid);
rc = DTSPTP(pli_string, ccsid);
rc = DTSPTF(fixed_len_string, length, ccsid);
```

--------------------------------

### Example of Setting a Custom Node Label

Source: https://docs.dynatrace.com/managed/observe/digital-experience/synthetic-monitoring/private-synthetic-locations/containerized-locations

An example demonstrating how to label a node with its specific availability zone.

```bash
kubectl label nodes ip-10-179-202-73.ec2.internal zone=us-east-1a
```

--------------------------------

### Environment API - Installer Agent Endpoints

Source: https://docs.dynatrace.com/managed/whats-new/dynatrace-api/sprint-341

Updates to the GET endpoints for downloading agent installers, including changes to the 'include' query parameter.

```APIDOC
## GET /deployment/installer/agent/{osType}/{installerType}

### Description
Retrieves agent installer details.

### Method
GET

### Endpoint
/deployment/installer/agent/{osType}/{installerType}/latest

### Parameters
#### Query Parameters
- **include** (string) - Optional - Specifies additional components to include. Enum values: `ruby`

### Endpoint
/deployment/installer/agent/{osType}/{installerType}/version/{version}

### Parameters
#### Query Parameters
- **include** (string) - Optional - Specifies additional components to include. Enum values: `ruby`

### Endpoint
/deployment/installer/agent/{osType}/{installerType}/version/{version}/checksum

### Parameters
#### Query Parameters
- **include** (string) - Optional - Specifies additional components to include. Enum values: `ruby`
```

--------------------------------

### Configuration YAML Example

Source: https://docs.dynatrace.com/managed/deliver/configuration-as-code/monaco/configuration/projects

Illustrates a basic configuration YAML file structure for Monaco projects. It includes sample configuration ID, name, and parameters.

```yaml
configs:
- id: sample
  config:
    name: "Sample"
    parameters:
      type: "simple"
      numericValue: 42
  [...]
```

--------------------------------

### OneAgent Installer Parameters

Source: https://docs.dynatrace.com/managed/ingest-from/amazon-web-services/integrate-into-aws/aws-ecs/deploy-oneagent-on-ecs

Customize OneAgent installation by adding installer parameters as environment variables. Separate parameters with spaces. Example includes setting application log content access and network zone.

```bash
--set-app-log-content-access=false --set-network-zone=<your.network.zone>
```

--------------------------------

### Node Installation Failure Error Example

Source: https://docs.dynatrace.com/managed/managed-cluster/configuration/configure-elevated-permissions

This error message indicates that the 'dtrun' command may not have the necessary elevated privileges to run during a Managed installation.

```text
Installation failed, with status: installer unpacked, system verified, connected to Mission Control, connected to Dynatrace cluster, added to Dynatrace cluster, agent downloaded after 2 minutes 44 seconds.
Exit code: 5

Errors:
Installation failed, with error Dtrun doesn't work properly, check if command "/opt/dtrun/dtrun" is permitted to run with elevated privileges. The dtrun validation failed with error: sudo: PAM account management error: Authentication service cannot retrieve authentication info
```

--------------------------------

### Mobile Application and Key User Actions Configuration

Source: https://docs.dynatrace.com/managed/deliver/configuration-as-code/monaco/configuration/yaml-configuration

Example demonstrating the configuration of a mobile application and its associated key user actions, using a reference for the scope.

```yaml
configs:
- id: mobile-application-id
  config:
    name: my-mobile-app
    template: mobile-app.json
    skip: false
    type:
      api: application-mobile
- id: MyKua
  type:
    api:
      name: key-user-actions-mobile
      template: kua.json
      scope:
        configId: mobile-application-id
        configType: application-mobile
        property: id
        type: reference

```

--------------------------------

### Start PurePath distributed trace in C

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-oneagent/installation-and-operation/zos/operation/cics-ims-sdk

C example of declaring and calling DTSP, DTSPTN, DTSPTP, and DTSPTF functions to start a distributed trace.

```C
int DTSP (void);
int DTSPTN (const char* c_string, const int* ccsid);
int DTSPTP (const void* pli_string, const int* ccsid);
int DTSPTF (const char* fixed_len_string, const int* length, const int* ccsid);
```

--------------------------------

### Example authorization.properties Entry

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-activegate/configuration/configure-an-environment-activegate-for-multi-environment-support

An example illustrating how to configure an environment within the `authorization.properties` file. This shows a sample `environment_ID`, `tenantToken`, `authToken`, and the `mainTenant` property set to `true`.

```properties
[mySampleEnv]
tenantToken = abcdevjhij1234567890
authToken = dt0g01.HVMTLRLZ.1234567890ZYXWVUTSRQPONMLKJIHGFEDCBA01234567890ABCDEFGHIGKLMNOPQ
mainTenant = true
```

--------------------------------

### ActiveGate Installation with CA Certificate

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-activegate/installation/linux/linux-customize-installation-for-activegate

Example command to install ActiveGate on Linux, specifying custom CA certificate and its password file for secure cluster connection.

```shell
[root@host]# ./Dynatrace-ActiveGate-Linux-1.217.sh --ca-certificate-file=/home/fred/myCert.jks  --ca-certificate-password-file=/home/fred/myPwd.txt
```

--------------------------------

### Get JavaScript Mapping Files Metadata

Source: https://docs.dynatrace.com/managed/dynatrace-api/environment-api/rum/js-mapping-files/get-js-mapping-files-metadata

This example shows how to retrieve metadata for JavaScript mapping files. It demonstrates a basic GET request to the API endpoint.

```shell
curl -X GET \
  'https://{your-domain}/e/{your-environment-id}/api/v2/jsMappingFiles/metadata' \
  -H 'Authorization: Api-Token YOUR_API_TOKEN'
```

--------------------------------

### Start OneAgent with Info.plist Configuration

Source: https://docs.dynatrace.com/managed/observe/digital-experience/mobile-applications/instrument-ios-app/customization/oneagent-sdk-for-ios

Use the `startupWithInfoPlistSettings` API call to start OneAgent using configuration from the `Info.plist` file. This operation must be performed on the main thread.

```swift
Dynatrace.startupWithInfoPlistSettings()

```

```objc
[Dynatrace startupWithInfoPlistSettings];

```

--------------------------------

### Get Available OneAgent Versions

Source: https://docs.dynatrace.com/managed/dynatrace-api/environment-api/deployment/oneagent/get-available-versions

Retrieves a list of available OneAgent installer versions for a specified OS type and installer type. Requires 'InstallerDownload' scope.

```APIDOC
## GET /e/{your-environment-id}/api/v1/deployment/installer/agent/versions/{osType}/{installerType}

### Description
Lists all available versions of OneAgent installer.

### Method
GET

### Endpoint
`https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/versions/{osType}/{installerType}`
OR
`https://{your-activegate-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/versions/{osType}/{installerType}`

### Parameters
#### Path Parameters
- **osType** (string) - Required - The operating system of the installer. Possible values: `windows`, `unix`, `aix`, `solaris`, `zos`
- **installerType** (string) - Required - The type of the installer. Possible values: `default`, `default-unattended`, `mainframe`, `paas`, `paas-sh`

#### Query Parameters
- **flavor** (string) - Optional - The flavor of your Linux distribution. Applicable to `paas` and `paas-sh` installer types. Possible values: `musl`, `multidistro`, `default`
- **arch** (string) - Optional - The architecture of your OS. Applicable to `paas` and `paas-sh` installer types. Possible values: `all`, `x86`, `ppc`, `ppcle`, `sparc`, `arm`, `s390`

### Response
#### Success Response (200)
- **availableVersions** (string[]) - A list of available versions of OneAgent installer.

#### Response Example
```json
{
  "availableVersions": [
    "string"
  ]
}
```
```

--------------------------------

### Download Using Manifest File

Source: https://docs.dynatrace.com/managed/deliver/configuration-as-code/monaco/reference/commands

Download configurations by specifying a manifest file and the target environment name.

```bash
monaco download --manifest your-manifest.yaml --environment environment-name
```

--------------------------------

### Get ActiveGate Version

Source: https://docs.dynatrace.com/managed/ingest-from/dynatrace-activegate/agctl-command-line-interface

Retrieve the current version information for the ActiveGate installation.

```bash
agctl version get
```