29. 유용성 분석 및 데이터 수집¶

29.1.1. 조직별 사용량¶

이 원형 차트는 특정 조직의 모든 작업(job) 내에서 실행된 작업(task) 수를 나타냅니다.

29.1.2. 조직별 작업 실행¶

이 원형 차트는 조직에서 실행한 작업 수로 계산되는, 모든 컨트롤러 클러스터의 조직별 컨트롤러 사용량을 나타냅니다.

29.1.3. 조직 상태¶

이 가로 막대형 차트는 조직에서 특정 날짜에 실행한 작업 수로 계산되는, 조직 및 날짜별 컨트롤러 사용량을 나타냅니다. 또는 1주, 2주, 월간 증분 기간의 조직별 작업 실행 수를 표시하도록 지정할 수 있습니다.

29.2.1. manifest.json¶

manifest.json은 분석 데이터 매니페스트입니다. 컬렉션에 포함된 각 파일과 포함된 해당 파일의 스키마 버전을 설명합니다. 예제 매니페스트는 다음과 같습니다.

{
  "config.json": "1.1",
  "counts.json": "1.0",
  "cred_type_counts.json": "1.0",
  "events_table.csv": "1.1",
  "instance_info.json": "1.0",
  "inventory_counts.json": "1.2",
  "job_counts.json": "1.0",
  "job_instance_counts.json": "1.0",
  "org_counts.json": "1.0",
  "projects_by_scm_type.json": "1.0",
  "query_info.json": "1.0",
  "unified_job_template_table.csv": "1.0",
  "unified_jobs_table.csv": "1.0",
  "workflow_job_node_table.csv": "1.0",
  "workflow_job_template_node_table.csv": "1.0"
}

29.2.2. config.json¶

config.json 파일에는 클러스터의 구성 끝점 /api/v2/config 서브 세트가 포함되어 있습니다. 예제 config.json은 다음과 같습니다.

{
    "ansible_version": "2.9.1",
    "authentication_backends": [
        "social_core.backends.azuread.AzureADOAuth2",
        "django.contrib.auth.backends.ModelBackend"
    ],
    "external_logger_enabled": true,
    "external_logger_type": "splunk",
    "free_instances": 1234,
    "install_uuid": "d3d497f7-9d07-43ab-b8de-9d5cc9752b7c",
    "instance_uuid": "bed08c6b-19cc-4a49-bc9e-82c33936e91b",
    "license_expiry": 34937373,
    "license_type": "enterprise",
    "logging_aggregators": [
        "awx",
        "activity_stream",
        "job_events",
        "system_tracking"
    ],
    "pendo_tracking": "detailed",
    "platform": {
        "dist": [
            "redhat",
            "7.4",
            "Maipo"
        ],
        "release": "3.10.0-693.el7.x86_64",
        "system": "Linux",
        "type": "traditional"
    },
    "total_licensed_instances": 2500,
    "controller_url_base": "https://ansible.rhdemo.io",
    "controller_version": "3.6.3"
}

수집되는 필드의 참조:

ansible_version

호스트의 시스템 Ansible 버전

authentication_backends

사용 가능한 사용자 인증 백엔드. 자세한 내용은 소셜 인증 설정 를 참조하거나 LDAP 인증 설정 참조하십시오.

external_logger_enabled

외부 로깅 활성화 여부

external_logger_type

활성화된 경우 사용 중인 로깅 백엔드. 자세한 내용은 :ref:`ag_logging`을 참조하십시오.

logging_aggregators

외부 로깅으로 전송되는 로깅 카테고리. 자세한 내용은 :ref:`ag_logging`을 참조하십시오.

free_instances

라이센스에서 사용할 수 있는 호스트 수. 값이 0이면 클러스터가 라이센스를 완전히 사용하고 있습니다.

install_uuid

설치 UUID(모든 클러스터 노드에 동일)

instance_uuid

인스턴스 UUID(클러스터 노드마다 다름)

license_expiry

라이센스 만료 시간(초)

license_type

라이센스 유형(대부분의 경우 〈enterprise’여야 함)

pendo_tracking

:ref:`usability_data_collection`의 상태

platform

클러스터를 실행 중인 운영 체제

total_licensed_instances

라이센스의 총 호스트 수

controller_url_base

클라이언트에서 사용하는 클러스터의 기본 URL(|AA|에 표시)

controller_version

클러스터의 소프트웨어 버전

29.2.3. instance_info.json¶

instance_info.json 파일에는 클러스터를 구성하는 인스턴스에 대한 자세한 정보가 인스턴스 UUID별로 포함되어 있습니다. 예제 instance_info.json은 다음과 같습니다.

{
    "bed08c6b-19cc-4a49-bc9e-82c33936e91b": {
        "capacity": 57,
        "cpu": 2,
        "enabled": true,
        "last_isolated_check": "2019-08-15T14:48:58.553005+00:00",
        "managed_by_policy": true,
        "memory": 8201400320,
        "uuid": "bed08c6b-19cc-4a49-bc9e-82c33936e91b",
        "version": "3.6.3"
    }
    "c0a2a215-0e33-419a-92f5-e3a0f59bfaee": {
        "capacity": 57,
        "cpu": 2,
        "enabled": true,
        "last_isolated_check": "2019-08-15T14:48:58.553005+00:00",
        "managed_by_policy": true,
        "memory": 8201400320,
        "uuid": "c0a2a215-0e33-419a-92f5-e3a0f59bfaee",
        "version": "3.6.3"
    }
}

수집되는 필드의 참조:

capacity

인스턴스의 작업 실행 용량. 계산 방법에 대한 자세한 내용은 <link>을(를) 참조하십시오.

cpu

인스턴스의 CPU 코어

memory

인스턴스의 메모리

enabled

인스턴스가 활성화되어 작업을 수락하는지 여부

managed_by_policy

인스턴스 그룹의 인스턴스 멤버십이 정책으로 관리되는지 또는 수동으로 관리되는지 여부

version

인스턴스의 소프트웨어 버전

29.2.4. counts.json¶

counts.json 파일에는 클러스터의 각 관련 카테고리에 대한 총 오브젝트 수가 포함되어 있습니다. 예제 count.json은 다음과 같습니다.

{
    "active_anonymous_sessions": 1,
    "active_host_count": 682,
    "active_sessions": 2,
    "active_user_sessions": 1,
    "credential": 38,
    "custom_inventory_script": 2,
    "custom_virtualenvs": 4,
    "host": 697,
    "inventories": {
        "normal": 20,
        "smart": 1
    },
    "inventory": 21,
    "job_template": 78,
    "notification_template": 5,
    "organization": 10,
    "pending_jobs": 0,
    "project": 20,
    "running_jobs": 0,
    "schedule": 16,
    "team": 5,
    "unified_job": 7073,
    "user": 28,
    "workflow_job_template": 15
}

활성 세션 수를 제외한 이 파일의 각 항목은 ``/api/v2``의 해당 API 오브젝트를 나타냅니다.

29.2.5. org_counts.json¶

org_counts.json 파일에는 클러스터의 각 조직 및 해당 조직과 연결된 사용자 및 팀 수가 포함되어 있습니다. 예제 org_counts.json은 다음과 같습니다.

{
    "1": {
        "name": "Operations",
        "teams": 5,
        "users": 17
    },
    "2": {
        "name": "Development",
        "teams": 27,
        "users": 154
    },
    "3": {
        "name": "Networking",
        "teams": 3,
        "users": 28
    }
}

29.2.6. cred_type_counts.json¶

cred_type_counts.json 파일에는 클러스터의 다양한 인증 정보 유형 및 각 유형의 인증 정보 수에 대한 정보가 포함되어 있습니다. 예제 cred_type_counts.json은 다음과 같습니다.

{
    "1": {
        "credential_count": 15,
        "managed_by_controller": true,
        "name": "Machine"
    },
    "2": {
        "credential_count": 2,
        "managed_by_controller": true,
        "name": "Source Control"
    },
    "3": {
        "credential_count": 3,
        "managed_by_controller": true,
        "name": "Vault"
    },
    "4": {
        "credential_count": 0,
        "managed_by_controller": true,
        "name": "Network"
    },
    "5": {
        "credential_count": 6,
        "managed_by_controller": true,
        "name": "Amazon Web Services"
    },
    "6": {
        "credential_count": 0,
        "managed_by_controller": true,
        "name": "OpenStack"
    },
...

29.2.7. inventory_counts.json¶

inventory_counts.json 파일에는 클러스터의 다양한 인벤토리에 대한 정보가 포함되어 있습니다. 예제 inventory_counts.json은 다음과 같습니다.

{
    "1": {
        "hosts": 211,
        "kind": "",
        "name": "AWS Inventory",
        "source_list": [
            {
                "name": "AWS",
                "num_hosts": 211,
                "source": "ec2"
            }
        ],
        "sources": 1
    },
    "2": {
        "hosts": 15,
        "kind": "",
        "name": "Manual inventory",
        "source_list": [],
        "sources": 0
    },
    "3": {
        "hosts": 25,
        "kind": "",
        "name": "SCM inventory - test repo",
        "source_list": [
            {
                "name": "Git source",
                "num_hosts": 25,
                "source": "scm"
            }
        ],
        "sources": 1
    }
    "4": {
        "num_hosts": 5,
        "kind": "smart",
        "name": "Filtered AWS inventory",
        "source_list": [],
        "sources": 0
    }
}

29.2.8. projects_by_scm_type.json¶

projects_by_scm_type.json 파일은 클러스터의 모든 프로젝트를 소스 제어 유형별로 분석합니다. 예제 projects_by_scm_type.json은 다음과 같습니다.

{
    "git": 27,
    "hg": 0,
    "insights": 1,
    "manual": 0,
    "svn": 0
}

29.2.9. query_info.json¶

query_info.json 파일은 데이터 수집 시기와 방법에 대한 세부 정보를 제공합니다. 예제 query_info.json은 다음과 같습니다.

{
    "collection_type": "manual",
    "current_time": "2019-11-22 20:10:27.751267+00:00",
    "last_run": "2019-11-22 20:03:40.361225+00:00"
}

collection_type은 《manual》 또는 《automatic》 중 하나입니다.

29.2.10. job_counts.json¶

job_counts.json 파일은 클러스터의 작업 기록에 대한 세부 정보를 제공하며 작업 시작 방법과 완료 상태를 설명합니다. 예제 job_counts.json은 다음과 같습니다.

{
    "launch_type": {
        "dependency": 3628,
        "manual": 799,
        "relaunch": 6,
        "scheduled": 1286,
        "scm": 6,
        "workflow": 1348
    },
    "status": {
        "canceled": 7,
        "failed": 108,
        "successful": 6958
    },
    "total_jobs": 7073
}

29.2.11. job_instance_counts.json¶

job_instance_counts.json 파일은 job_counts.json과 동일한 세부 정보를 인스턴스별로 분석하여 제공합니다. 예제 job_instance_counts.json은 다음과 같습니다.

{
    "localhost": {
        "launch_type": {
            "dependency": 3628,
            "manual": 770,
            "relaunch": 3,
            "scheduled": 1009,
            "scm": 6,
            "workflow": 1336
        },
        "status": {
            "canceled": 2,
            "failed": 60,
            "successful": 6690
        }
    }
}

이 파일의 인스턴스는 instance_info에 있으므로 UUID가 아닌 호스트 이름별로 구성되어 있습니다.

29.2.12. unified_job_template_table.csv¶

unified_job_template_table.csv 파일은 시스템의 작업 템플릿에 대한 정보를 제공합니다. 각 행에는 작업 템플릿에 대한 다음 필드가 포함되어 있습니다.

id

작업 템플릿 ID

name

작업 템플릿 이름

polymorphic_ctype_id

템플릿 유형 ID

model

템플릿의 polymorphic_ctype_id 이름. 예를 들어 〈project〉, 〈systemjobtemplate〉, 〈jobtemplate〉, 〈inventorysource〉, 〈workflowjobtemplate〉 등이 있습니다.

created

템플릿이 생성된 시간

modified

템플릿이 마지막으로 업데이트된 시간

created_by_id

템플릿을 생성한 userid. 시스템에서 수행한 경우 비어 있습니다.

modified_by_id

템플릿을 마지막으로 수정한 userid. 시스템에서 수행한 경우 비어 있습니다.

current_job_id

템플릿에 대해 현재 실행 중인 작업 ID(있는 경우)

last_job_id

마지막 작업 실행

last_job_run

마지막 작업 실행 시간

last_job_failed

last_job_id가 실패했는지 여부

status

last_job_id 상태

next_job_run

다음 스케줄링된 템플릿 실행(있는 경우)

next_schedule_id

next_job_run의 스케줄 ID(있는 경우)

29.2.13. unified_jobs_table.csv¶

unified_jobs_table.csv 파일은 시스템에서 실행하는 작업에 대한 정보를 제공합니다. 각 행에는 작업에 대한 다음 필드가 포함되어 있습니다.

id

작업 ID

name

작업 이름(템플릿)

polymorphic_ctype_id

작업 유형 ID

model

작업의 polymorphic_ctype_id 이름. 예를 들어 〈job〉, 〈worfklow〉 등이 있습니다.

organization_id

작업의 조직 ID

organization_name

organization_id 이름

created

작업 레코드가 생성된 시간

started

작업 실행이 시작된 시간

finished

작업이 완료된 시간

elapsed

작업 경과 시간(초)

unified_job_template_id

이 작업의 템플릿

launch_type

《manual》, 《scheduled》, 《relaunched》, 《scm》, 《workflow》 또는 《dependnecy》 중 하나

schedule_id

작업을 시작한 스케줄 ID(있는 경우)

instance_group_id

작업을 실행한 인스턴스 그룹

execution_node

작업을 실행한 노드(호스트 이름, UUID 아님)

controller_node

격리된 작업으로 또는 컨테이너 그룹에서 실행된 경우 작업의 컨트롤러 노드

cancel_flag

작업이 취소되었는지 여부

status

작업 상태

failed

작업이 실패했는지 여부

job_explanation

제대로 실행되지 않은 작업에 대한 추가 세부 정보

포크

이 작업에 대해 실행된 포크 수

29.2.14. workflow_job_template_node_table.csv¶

workflow_job_template_node_table.csv는 시스템의 워크플로우 작업 템플릿에 정의된 노드에 대한 정보를 제공합니다.

각 행에는 워크플로우 작업 템플릿 노드에 대한 다음 필드가 포함되어 있습니다.

id

노드 ID

created

노드가 생성된 시간

modified

노드가 마지막으로 업데이트된 시간

unified_job_template_id

이 노드에 대한 작업 템플릿, 프로젝트, 인벤토리 또는 기타 상위 리소스의 ID

workflow_job_template_id

이 노드가 포함된 워크플로우 작업 템플릿

inventory_id

이 노드에서 사용하는 인벤토리

success_nodes

이 노드가 성공한 후 트리거되는 노드

failure_nodes

이 노드가 실패한 후 트리거되는 노드

always_nodes

이 노드가 완료된 후 항상 트리거되는 노드

all_parents_must_converge

이 노드를 시작하기 위해 모든 상위 조건이 충족되어야 하는지 여부

29.2.15. workflow_job_node_table.csv¶

workflow_job_node_table.csv는 시스템에서 워크플로우의 일부로 실행된 작업에 대한 정보를 제공합니다.

각 행에는 워크플로우의 일부로 실행된 작업에 대한 다음 필드가 포함되어 있습니다.

id

노드 ID

created

노드 레코드가 생성된 시간

modified

노드 레코드가 마지막으로 업데이트된 시간

job_id

이 노드에 대한 작업 실행의 작업 ID

unified_job_tempalte_id

이 작업 실행에 대한 작업 템플릿, 프로젝트, 인벤토리 또는 기타 상위 리소스의 ID

workflow_job_id

이 작업 실행에 대한 상위 워크플로우 작업

inventory_id

이 작업에서 사용하는 인벤토리

success_nodes

이 노드가 성공한 후 트리거된 노드

failure_nodes

이 노드가 실패한 후 트리거된 노드

always_nodes

이 노드가 완료된 후 트리거된 노드

do_not_run

시작 조건이 트리거되지 않아 워크플로우에서 실행되지 않은 노드

all_parents_must_converge

이 노드를 시작하기 위해 모든 상위 조건이 충족되어야 했는지 여부

29.2.16. events_table.csv¶

events_table.csv 파일은 시스템의 모든 작업 실행에서 발생한 모든 작업 이벤트에 대한 정보를 제공합니다. 각 행에는 작업 이벤트에 대한 다음 필드가 포함되어 있습니다.

id

이벤트 ID

uuid

이벤트 UUID

created

이벤트가 생성된 시간

parent_uuid

이 이벤트의 상위 UUID(있는 경우)

event

Ansible 이벤트 유형(예: runner_on_failed)

task_action

이 이벤트와 연결된 모듈(있는 경우)(예: 〈command〉 또는 〈yum〉)

failed

이벤트에서 《failed》가 반환되었는지 여부

changed

이벤트에서 《changed》가 반환되었는지 여부

playbook

이벤트와 연결된 플레이북

play

플레이북의 플레이 이름

task

플레이북의 작업 이름

role

플레이북의 역할 이름

job_id

이 이벤트가 발생한 작업 ID

host_id

이 이벤트가 연결된 호스트 ID(있는 경우)

host_name

이 이벤트가 연결된 호스트 이름(있는 경우)

start

작업 시작 시간

end

작업 종료 시간

duration

작업 기간

warnings

작업/모듈의 경고

deprecations

작업/모듈의 중단 경고