# aws/aws-graviton-getting-started architecture

> Architecture diagram of the GitHub repository aws/aws-graviton-getting-started, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws/aws-graviton-getting-started
- Repository: https://github.com/aws/aws-graviton-getting-started

## Overview

This repository is a technical guide and collection of practical resources for running, transitioning, building, and optimizing workloads on AWS Graviton and Arm systems. The principal user journey is documented as identifying workloads, planning a transition, testing, and deploying; related branches cover architecture and language guidance, performance analysis, HPC, machine learning, and examples. Relationships are based on the README’s stated structure and the supplied source excerpts/index; unsampled resource links are documented navigation, not inspected runtime integrations.

Main entry points: [`README.md`](https://github.com/aws/aws-graviton-getting-started/blob/main/README.md) (Guide overview), [`perfrunbook/utilities`](https://github.com/aws/aws-graviton-getting-started/tree/main/perfrunbook/utilities) (Measurement utilities), [`perfrunbook/utilities/measure_and_plot_basic_sysstat_stats.py`](https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/measure_and_plot_basic_sysstat_stats.py) (Sysstat measurement), [`transition-guide.md`](https://github.com/aws/aws-graviton-getting-started/blob/main/transition-guide.md) (Transition workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Core guidance"]
  node_overview["Guide overview<br/>[README.md]"]
  node_transition["Transition workflow"]
  node_build["Build guidance<br/>[c-c++.md]"]
  node_languages["Language guides"]
  node_containers["Containers<br/>[containers.md]"]
  node_os["OS support<br/>[os.md]"]
  node_java["Java guide<br/>[java.md]"]
end

subgraph group_optimization["Performance tools"]
  node_optimizing["Optimization guide<br/>[optimizing.md]"]
  node_simd["SIMD guidance"]
  node_hwcaps["Runtime feature detection"]
  node_runbook["Performance runbook<br/>[README.md]"]
  node_runbook_tools["Measurement utilities"]
  node_sysstat_measure["Sysstat measurement"]
  node_sar_parser["SAR parser<br/>[sar_parse.py]"]
  node_mpstat_parser["Mpstat parser<br/>[mpstat_parse.py]"]
  node_pmu_measure["PMU analysis"]
  node_pmu_aggregate["Aggregated PMU stats"]
end

subgraph group_workloads["Workload examples"]
  node_hpc["HPC workflows<br/>[README.md]"]
  node_lambda["Lambda examples<br/>[README.md]"]
  node_ffmpeg["FFmpeg build<br/>[README.md]"]
end

subgraph group_specialized["Specialized guides"]
  node_machine_learning["Machine learning"]
  node_analytics["Spark analytics<br/>[DataAnalytics.md]"]
  node_datapath["Datapath software<br/>[dpdk_spdk.md]"]
end

subgraph group_agent["Agent skills"]
  node_skills["Java migration skill<br/>[README.md]"]
end

node_reader(("Graviton user"))

node_reader -->|"starts at"| node_overview
node_overview -->|"links to"| node_transition
node_transition -->|"guides identify-plan-test-deploy"| node_reader
node_overview -->|"links to"| node_build
node_overview -->|"links to"| node_languages
node_overview -->|"links to"| node_containers
node_overview -->|"links to"| node_os
node_overview -->|"links to"| node_optimizing
node_overview -->|"links to"| node_simd
node_overview -->|"links to"| node_hwcaps
node_overview -->|"links to"| node_runbook
node_runbook -->|"provides utilities"| node_runbook_tools
node_overview -->|"links to"| node_hpc
node_overview -->|"links to"| node_lambda
node_overview -->|"links to"| node_ffmpeg
node_overview -->|"links to"| node_machine_learning
node_overview -->|"links to"| node_analytics
node_overview -->|"links to"| node_datapath
node_overview -->|"links to"| node_skills
node_overview -->|"links to"| node_java
node_sysstat_measure -->|"parses output"| node_sar_parser
node_sysstat_measure -->|"parses output"| node_mpstat_parser
node_runbook_tools -->|"includes"| node_sysstat_measure
node_runbook_tools -->|"includes"| node_pmu_measure
node_runbook_tools -->|"includes"| node_pmu_aggregate

click node_overview "https://github.com/aws/aws-graviton-getting-started/blob/main/README.md"
click node_transition "https://github.com/aws/aws-graviton-getting-started/blob/main/transition-guide.md"
click node_build "https://github.com/aws/aws-graviton-getting-started/blob/main/c-c%2B%2B.md"
click node_containers "https://github.com/aws/aws-graviton-getting-started/blob/main/containers.md"
click node_os "https://github.com/aws/aws-graviton-getting-started/blob/main/os.md"
click node_optimizing "https://github.com/aws/aws-graviton-getting-started/blob/main/optimizing.md"
click node_simd "https://github.com/aws/aws-graviton-getting-started/blob/main/SIMD_and_vectorization.md"
click node_hwcaps "https://github.com/aws/aws-graviton-getting-started/blob/main/runtime-feature-detection.md"
click node_runbook "https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/README.md"
click node_runbook_tools "https://github.com/aws/aws-graviton-getting-started/tree/main/perfrunbook/utilities"
click node_hpc "https://github.com/aws/aws-graviton-getting-started/blob/main/HPC/README.md"
click node_lambda "https://github.com/aws/aws-graviton-getting-started/blob/main/aws-lambda/README.md"
click node_ffmpeg "https://github.com/aws/aws-graviton-getting-started/blob/main/video-encoding/ffmpeg-build/README.md"
click node_machine_learning "https://github.com/aws/aws-graviton-getting-started/tree/main/machinelearning"
click node_analytics "https://github.com/aws/aws-graviton-getting-started/blob/main/DataAnalytics.md"
click node_datapath "https://github.com/aws/aws-graviton-getting-started/blob/main/dpdk_spdk.md"
click node_skills "https://github.com/aws/aws-graviton-getting-started/blob/main/tools/skills/languages/java-x86-to-graviton/README.md"
click node_sysstat_measure "https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/measure_and_plot_basic_sysstat_stats.py"
click node_sar_parser "https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/sar_parse.py"
click node_mpstat_parser "https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/mpstat_parse.py"
click node_pmu_measure "https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/measure_and_plot_basic_pmu_counters.py"
click node_pmu_aggregate "https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/measure_aggregated_pmu_stats.py"
click node_java "https://github.com/aws/aws-graviton-getting-started/blob/main/java.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_overview,node_transition,node_build,node_languages,node_containers,node_os,node_java,node_reader toneBlue
class node_optimizing,node_simd,node_hwcaps,node_runbook,node_runbook_tools,node_sysstat_measure,node_sar_parser,node_mpstat_parser,node_pmu_measure,node_pmu_aggregate toneAmber
class node_hpc,node_lambda,node_ffmpeg toneMint
class node_machine_learning,node_analytics,node_datapath toneRose
class node_skills toneIndigo
```

## Components

### Core guidance

- [Guide overview](https://github.com/aws/aws-graviton-getting-started/blob/main/README.md): `README.md`
- [Transition workflow](https://github.com/aws/aws-graviton-getting-started/blob/main/transition-guide.md): `transition-guide.md`
- [Build guidance](https://github.com/aws/aws-graviton-getting-started/blob/main/c-c%2B%2B.md): `c-c++.md`
- **Language guides**
- [Containers](https://github.com/aws/aws-graviton-getting-started/blob/main/containers.md): `containers.md`
- [OS support](https://github.com/aws/aws-graviton-getting-started/blob/main/os.md): `os.md`
- [Java guide](https://github.com/aws/aws-graviton-getting-started/blob/main/java.md): `java.md`

### Performance tools

- [Optimization guide](https://github.com/aws/aws-graviton-getting-started/blob/main/optimizing.md): `optimizing.md`
- [SIMD guidance](https://github.com/aws/aws-graviton-getting-started/blob/main/SIMD_and_vectorization.md): `SIMD_and_vectorization.md`
- [Runtime feature detection](https://github.com/aws/aws-graviton-getting-started/blob/main/runtime-feature-detection.md): `runtime-feature-detection.md`
- [Performance runbook](https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/README.md): `perfrunbook/README.md`
- [Measurement utilities](https://github.com/aws/aws-graviton-getting-started/tree/main/perfrunbook/utilities): `perfrunbook/utilities`
- [Sysstat measurement](https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/measure_and_plot_basic_sysstat_stats.py): `perfrunbook/utilities/measure_and_plot_basic_sysstat_stats.py`
- [SAR parser](https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/sar_parse.py): `perfrunbook/utilities/sar_parse.py`
- [Mpstat parser](https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/mpstat_parse.py): `perfrunbook/utilities/mpstat_parse.py`
- [PMU analysis](https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/measure_and_plot_basic_pmu_counters.py): `perfrunbook/utilities/measure_and_plot_basic_pmu_counters.py`
- [Aggregated PMU stats](https://github.com/aws/aws-graviton-getting-started/blob/main/perfrunbook/utilities/measure_aggregated_pmu_stats.py): `perfrunbook/utilities/measure_aggregated_pmu_stats.py`

### Workload examples

- [HPC workflows](https://github.com/aws/aws-graviton-getting-started/blob/main/HPC/README.md): `HPC/README.md`
- [Lambda examples](https://github.com/aws/aws-graviton-getting-started/blob/main/aws-lambda/README.md): `aws-lambda/README.md`
- [FFmpeg build](https://github.com/aws/aws-graviton-getting-started/blob/main/video-encoding/ffmpeg-build/README.md): `video-encoding/ffmpeg-build/README.md`

### Specialized guides

- [Machine learning](https://github.com/aws/aws-graviton-getting-started/tree/main/machinelearning): `machinelearning`
- [Spark analytics](https://github.com/aws/aws-graviton-getting-started/blob/main/DataAnalytics.md): `DataAnalytics.md`
- [Datapath software](https://github.com/aws/aws-graviton-getting-started/blob/main/dpdk_spdk.md): `dpdk_spdk.md`

### Agent skills

- [Java migration skill](https://github.com/aws/aws-graviton-getting-started/blob/main/tools/skills/languages/java-x86-to-graviton/README.md): `tools/skills/languages/java-x86-to-graviton/README.md`

### Other components

- **Graviton user**

## Connections

- Graviton user → Guide overview: starts at (evidence: `README.md`)
- Guide overview → Transition workflow: links to (evidence: `README.md`)
- Transition workflow → Graviton user: guides identify-plan-test-deploy (evidence: `README.md`)
- Guide overview → Build guidance: links to (evidence: `README.md`)
- Guide overview → Language guides: links to (evidence: `README.md`)
- Guide overview → Containers: links to (evidence: `README.md`)
- Guide overview → OS support: links to (evidence: `README.md`)
- Guide overview → Optimization guide: links to (evidence: `README.md`)
- Guide overview → SIMD guidance: links to (evidence: `README.md`)
- Guide overview → Runtime feature detection: links to (evidence: `README.md`)
- Guide overview → Performance runbook: links to (evidence: `README.md`)
- Performance runbook → Measurement utilities: provides utilities (evidence: `README.md`)
- Guide overview → HPC workflows: links to (evidence: `README.md`)
- Guide overview → Lambda examples: links to (evidence: `README.md`)
- Guide overview → FFmpeg build: links to (evidence: `README.md`)
- Guide overview → Machine learning: links to (evidence: `README.md`)
- Guide overview → Spark analytics: links to (evidence: `README.md`)
- Guide overview → Datapath software: links to (evidence: `README.md`)
- Guide overview → Java migration skill: links to (evidence: `README.md`)
- Guide overview → Java guide: links to (evidence: `README.md`)
- Sysstat measurement → SAR parser: parses output (evidence: `perfrunbook/utilities/measure_and_plot_basic_sysstat_stats.py`)
- Sysstat measurement → Mpstat parser: parses output (evidence: `perfrunbook/utilities/measure_and_plot_basic_sysstat_stats.py`)
- Measurement utilities → Sysstat measurement: includes (evidence: `README.md`)
- Measurement utilities → PMU analysis: includes (evidence: `README.md`)
- Measurement utilities → Aggregated PMU stats: includes (evidence: `README.md`)