Name | dt-extension-migrator JSON |
Version |
0.5.1
JSON |
| download |
home_page | None |
Summary | None |
upload_time | 2024-10-02 19:52:57 |
maintainer | None |
docs_url | None |
author | Your Name |
requires_python | <4.0,>=3.10 |
license | None |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# Dynatrace Extension Migrator
Helps with moving the configurations of select Extensions 1.0 extensions to their 2.0 equivalents.
## Requirements
- Python 3.10+
- An API token:
- Ust the 'Extension Development' token or provide the following scopes:
- extensions.read
- extensionConfigurations.read
- extensionConfigurations.write
## Installation
`pip install dt-extension-migrator`
## Usage
Each supported EF1 extension has a subcommand e.g. `dt-ext-migrator remote-unix --help`
Each will have a similar set of commands for pulling the EF1 configurations and pushing the converted EF2 extensions to the Dynatrace environment.
### Environment details
You can specify the Dynatrace environment URL and API token either in the `--dt-url` and `--dt-token` options or in DT_URL and DT_TOKEN environment variables (recommended).
### Pulling configurations
When pulling EF1 configurations you can specify the output file (optional) and one or more "indexes" by specifying the `--index` option for each field you want to 'group' configurations on. For example, if you want to group just on the 'group' in the EF1 configuration you can run:
`dt-ext-migrator remote-unix pull --index group`
If you want to group by the group and the configured username you can run:
`dt-ext-migrator remote-unix pull --index group --index username`
You will have an Excel spreadsheet generated with a tab for each set of grouped dimensions you will be able to use when pushing the converted configs.
### Pushing configurations
Once you have the spreadsheet generated you can use this to convert and push the configurations to their EF2 equivalents.
`dt-ext-migrator remote-unix push --input-file .\custom.remote.python.remote_agent-export.xlsx --sheet group1-myuser --version 1.0.0 --ag-group ag_group-default`
### Tips:
- The --ag-group option can be specified with or without the leading `ag_group-` prefix
- Fields you should review/update manually will be the authentication (top-level monitoring configuration level is recommended) and the top-level 'group' setting if used
A summary will be printed after a successful push. E.g.:
```
2 endpoints will attempt to be added to the monitoring configuration.
Configs created successfully. Response: 200
Link to monitoring configuration: https://<environment>/ui/hub/ext/listing/registered/<extensionId>/fe14090c-4bfe-30b5-b88b-84a8e6f65607/read
```
The configuration will be disabled by default so you can review it, add authentication, and making any other needed chagnes before enabling.
Raw data
{
"_id": null,
"home_page": null,
"name": "dt-extension-migrator",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Your Name",
"author_email": "you@example.com",
"download_url": "https://files.pythonhosted.org/packages/86/26/ac580a4550a4e73d67d1ac917832f9cf1150586bd9e661e3f2cab15a106f/dt_extension_migrator-0.5.1.tar.gz",
"platform": null,
"description": "# Dynatrace Extension Migrator\n\nHelps with moving the configurations of select Extensions 1.0 extensions to their 2.0 equivalents.\n\n## Requirements\n\n- Python 3.10+\n- An API token:\n - Ust the 'Extension Development' token or provide the following scopes:\n - extensions.read\n - extensionConfigurations.read\n - extensionConfigurations.write\n\n## Installation\n\n`pip install dt-extension-migrator`\n\n## Usage\nEach supported EF1 extension has a subcommand e.g. `dt-ext-migrator remote-unix --help`\n\nEach will have a similar set of commands for pulling the EF1 configurations and pushing the converted EF2 extensions to the Dynatrace environment.\n\n### Environment details\nYou can specify the Dynatrace environment URL and API token either in the `--dt-url` and `--dt-token` options or in DT_URL and DT_TOKEN environment variables (recommended).\n\n### Pulling configurations\nWhen pulling EF1 configurations you can specify the output file (optional) and one or more \"indexes\" by specifying the `--index` option for each field you want to 'group' configurations on. For example, if you want to group just on the 'group' in the EF1 configuration you can run:\n\n`dt-ext-migrator remote-unix pull --index group`\n\nIf you want to group by the group and the configured username you can run:\n\n`dt-ext-migrator remote-unix pull --index group --index username`\n\nYou will have an Excel spreadsheet generated with a tab for each set of grouped dimensions you will be able to use when pushing the converted configs.\n\n### Pushing configurations\nOnce you have the spreadsheet generated you can use this to convert and push the configurations to their EF2 equivalents.\n\n`dt-ext-migrator remote-unix push --input-file .\\custom.remote.python.remote_agent-export.xlsx --sheet group1-myuser --version 1.0.0 --ag-group ag_group-default`\n\n### Tips:\n - The --ag-group option can be specified with or without the leading `ag_group-` prefix\n - Fields you should review/update manually will be the authentication (top-level monitoring configuration level is recommended) and the top-level 'group' setting if used\n\nA summary will be printed after a successful push. E.g.:\n```\n2 endpoints will attempt to be added to the monitoring configuration.\nConfigs created successfully. Response: 200\nLink to monitoring configuration: https://<environment>/ui/hub/ext/listing/registered/<extensionId>/fe14090c-4bfe-30b5-b88b-84a8e6f65607/read\n```\n\nThe configuration will be disabled by default so you can review it, add authentication, and making any other needed chagnes before enabling.",
"bugtrack_url": null,
"license": null,
"summary": null,
"version": "0.5.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2bc84e8be39870e35da4ac5560f09ef64fab71a60b4640cea9394cb3a3638152",
"md5": "2fc5e9b1e972806e27b4a28c1f4576c2",
"sha256": "b6305fdc472ac35b7fdedf5b1d274bf046d0de9d4d8ea0e70d1a10b3aae8ad4b"
},
"downloads": -1,
"filename": "dt_extension_migrator-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2fc5e9b1e972806e27b4a28c1f4576c2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 27774,
"upload_time": "2024-10-02T19:52:54",
"upload_time_iso_8601": "2024-10-02T19:52:54.900600Z",
"url": "https://files.pythonhosted.org/packages/2b/c8/4e8be39870e35da4ac5560f09ef64fab71a60b4640cea9394cb3a3638152/dt_extension_migrator-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8626ac580a4550a4e73d67d1ac917832f9cf1150586bd9e661e3f2cab15a106f",
"md5": "b8204be23ebd19ee1bc62d3eb882fb4a",
"sha256": "aa876469cd11b7a1be688bf2d79dbf3b6d5de3727bf4ccb9c089bce3efaeabab"
},
"downloads": -1,
"filename": "dt_extension_migrator-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "b8204be23ebd19ee1bc62d3eb882fb4a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 62842,
"upload_time": "2024-10-02T19:52:57",
"upload_time_iso_8601": "2024-10-02T19:52:57.012256Z",
"url": "https://files.pythonhosted.org/packages/86/26/ac580a4550a4e73d67d1ac917832f9cf1150586bd9e661e3f2cab15a106f/dt_extension_migrator-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-02 19:52:57",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "dt-extension-migrator"
}