# Dynatrace onboarding repo / Terreform config
This repository holds the Dynatrace configuration for onboarding purposes

# Prerequisites

## Python packages
Before executing scripts, python requirements have to be satisfied. To do so, execute following command:
	pip install -r requirements.txt

# Instructions

    1. Clone template:
        git clone --branch template https://atc.bmwgroup.net/bitbucket/scm/opapm/coco_apm_terraform_onboarding.git
    2. Change directory:
        cd coco_apm_terraform_onboarding
    3. Create branch:
        git checkout -b CD_<appname>
    4.Install python dependencies:
        pip install -r requirements.txt
    5.Run onboarding script:
        4.1 Default implementation (Management zone, Alerting profile and predefined dashboard)
            python ./onboarding.py -A CD_<app_name> -C <compass_id>
        4.2 Additional features (see Usage section):
            python ./onboarding.py -A CD_<app_name> -C <compass_id> -F <features>
    6. Review created files:
        git status

        5.1 Adjust additional feature files (if generated with "-F" option). See "Adjusting tf files" section
    7. Commit your changes:
        git add <changes>
 
        git commit -m "<OPMAAS-XXX> - Add initial configuration of application <app_name> to Dynatrace"
 
        git push -u origin CD_<app_name>
    8. Create pull request from CD_<app_name> to master

# Adjusting tf files

For more information about adjusting tf files to your need please follow:
1. Management zones: https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/resources/management_zone
2. Alerting profiles: https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/resources/alerting
3. Dashboards: https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/resources/dashboard
4. Custom service: https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/resources/custom_service
5. Notification: https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/resources/notification
6. Process group naming: https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/resources/processgroup_naming
7. Service naming: https://registry.terraform.io/providers/dynatrace-oss/dynatrace/latest/docs/resources/service_naming

# Usage
    usage: onboarding.py [-h] -A APPNAME -C COMPASSID -F FEATURES

    Generate predefined Dynatrace configuration via Terraform. Default features are Management zone, Alerting profile and predefined dashboard. For more see
    options below

    options:
    -h, --help            show this help message and exit
    -A APPNAME, --appname APPNAME
                            Your app_name (default: None)
    -C COMPASSID, --compassid COMPASSID
                            Your compass_id (default: None)
    -F FEATURES, --features FEATURES
                            Comma separated additional features. Possible options are: custom_service,processgroup_naming,service_naming (default: None)

# Files

## _templates folder

Please do not change template files inside this folder. If any of this files will be changed, your pull request will be rejected.

## onboarding.py

This scripts generates predefined configuration basing on your app_name and compass ids

## requirements.txt

File containing required python packages