diff --git a/assets/js/registrySearch.js b/assets/js/registrySearch.js index d91c590585a3..c15796154337 100644 --- a/assets/js/registrySearch.js +++ b/assets/js/registrySearch.js @@ -239,3 +239,8 @@ function parseUrlParams() { selectedLanguage = urlParams.get('language') || 'all'; selectedComponent = urlParams.get('component') || 'all'; } + +var tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]')) +var tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) { + return new bootstrap.Tooltip(tooltipTriggerEl) +}) diff --git a/content/en/ecosystem/registry/help.md b/content/en/ecosystem/registry/help.md new file mode 100644 index 000000000000..6ddc3ffa7262 --- /dev/null +++ b/content/en/ecosystem/registry/help.md @@ -0,0 +1,48 @@ +# Component Types Help + +This page provides an overview of the different types of components in the OpenTelemetry ecosystem, including examples and explanations. + +## Component Types + +### Application Integration +- **Description**: Components that help integrate OpenTelemetry into existing applications or services. +- **Example**: Libraries that enable the export of telemetry data in OpenTelemetry formats. + +### Core +- **Description**: Fundamental components that are essential for OpenTelemetry's core functionality. +- **Example**: Core SDKs and libraries that provide basic tracing and metrics support. + +### Exporter +- **Description**: Components that handle exporting telemetry data to various backends. +- **Example**: Exporters that send telemetry data to cloud platforms or monitoring services. + +### Extension +- **Description**: Additional features that extend the capabilities of the OpenTelemetry Collector. +- **Example**: Plugins or modules that add specific functionalities to the Collector. + +### Instrumentation +- **Description**: Libraries for specific programming languages that automatically capture telemetry data from applications. +- **Example**: Java Util Logging Instrumentation for capturing logs in Java applications. + +### Log Bridge +- **Description**: Bridges between OpenTelemetry and logging systems, allowing logs to be processed with telemetry data. +- **Example**: Adapters that connect application logs with OpenTelemetry systems. + +### Processor +- **Description**: Components that modify or enrich telemetry data before it's exported. +- **Example**: Processors that filter or add metadata to spans before exporting. + +### Receiver +- **Description**: Components responsible for receiving telemetry data in various formats. +- **Example**: Receivers that support multiple telemetry protocols, like OTLP or Jaeger. + +### Resource Detector +- **Description**: Automatically detects resource information, such as cloud environment metadata. +- **Example**: Components that identify and add resource tags to telemetry data. + +### Utilities +- **Description**: Miscellaneous helper tools and libraries that aid in the management and processing of telemetry data. +- **Example**: Utility libraries for handling common data transformations or protocol conversions. + +## Additional Resources +- For more information on licenses, visit [Open Source Licenses](https://opensource.org/licenses). diff --git a/layouts/partials/ecosystem/registry/entry.html b/layouts/partials/ecosystem/registry/entry.html index 9a282c4db0b9..79614bac8f87 100644 --- a/layouts/partials/ecosystem/registry/entry.html +++ b/layouts/partials/ecosystem/registry/entry.html @@ -1,95 +1,96 @@ {{ $languageNames := .languageNames -}} {{ with .value -}} - {{ - $remoteRegistries := dict - "npm" (dict - "urlPattern" "https://npmjs.com/package/%s" - "installTemplate" "ecosystem/registry/quickinstall/default.md" - "installLine" "npm install %s" - "icon" "fab fa-npm") - "packagist" (dict - "urlPattern" "https://packagist.org/packages/%s" - "installLine" "composer require %s" - "installTemplate" "ecosystem/registry/quickinstall/default.md" - "icon" "fa-solid fa-box-open") - "gems" (dict - "urlPattern" "https://rubygems.org/gems/%s" - "installLine" "gem install %s" - "installTemplate" "ecosystem/registry/quickinstall/default.md" - "icon" "fa-solid fa-gem") - "go" (dict - "urlPattern" "https://pkg.go.dev/%s" - "installLine" "go get %s" - "installTemplate" "ecosystem/registry/quickinstall/default.md" - "icon" "fa-brands fa-golang") - "go-collector" (dict - "urlPattern" "https://pkg.go.dev/%s" - "installTemplate" "ecosystem/registry/quickinstall/collector.md" - "icon" "fa-solid fa-box-open") - "nuget" (dict - "urlPattern" "https://www.nuget.org/packages/%s" - "installLine" "dotnet add package %s" - "installTemplate" "ecosystem/registry/quickinstall/default.md" - "icon" "fa-solid fa-box-open") - "pip" (dict - "urlPattern" "https://pypi.org/project/%s" - "installLine" "pip install %s" - "installTemplate" "ecosystem/registry/quickinstall/default.md" - "icon" "fa-brands fa-python") - "hex" (dict - "urlPattern" "https://hex.pm/packages/%s" - "installTemplate" "ecosystem/registry/quickinstall/hex.md" - "icon" "fa-brands fa-erlang") - "crates" (dict - "urlPattern" "https://crates.io/crates/%s" - "installLine" "cargo add %s" - "installTemplate" "ecosystem/registry/quickinstall/default.md" - "icon" "fab fa-rust") - -}} +{{ +$remoteRegistries := dict +"npm" (dict +"urlPattern" "https://npmjs.com/package/%s" +"installTemplate" "ecosystem/registry/quickinstall/default.md" +"installLine" "npm install %s" +"icon" "fab fa-npm") +"packagist" (dict +"urlPattern" "https://packagist.org/packages/%s" +"installLine" "composer require %s" +"installTemplate" "ecosystem/registry/quickinstall/default.md" +"icon" "fa-solid fa-box-open") +"gems" (dict +"urlPattern" "https://rubygems.org/gems/%s" +"installLine" "gem install %s" +"installTemplate" "ecosystem/registry/quickinstall/default.md" +"icon" "fa-solid fa-gem") +"go" (dict +"urlPattern" "https://pkg.go.dev/%s" +"installLine" "go get %s" +"installTemplate" "ecosystem/registry/quickinstall/default.md" +"icon" "fa-brands fa-golang") +"go-collector" (dict +"urlPattern" "https://pkg.go.dev/%s" +"installTemplate" "ecosystem/registry/quickinstall/collector.md" +"icon" "fa-solid fa-box-open") +"nuget" (dict +"urlPattern" "https://www.nuget.org/packages/%s" +"installLine" "dotnet add package %s" +"installTemplate" "ecosystem/registry/quickinstall/default.md" +"icon" "fa-solid fa-box-open") +"pip" (dict +"urlPattern" "https://pypi.org/project/%s" +"installLine" "pip install %s" +"installTemplate" "ecosystem/registry/quickinstall/default.md" +"icon" "fa-brands fa-python") +"hex" (dict +"urlPattern" "https://hex.pm/packages/%s" +"installTemplate" "ecosystem/registry/quickinstall/hex.md" +"icon" "fa-brands fa-erlang") +"crates" (dict +"urlPattern" "https://crates.io/crates/%s" +"installLine" "cargo add %s" +"installTemplate" "ecosystem/registry/quickinstall/default.md" +"icon" "fab fa-rust") +-}} {{ $isNative := and (or (eq .registryType "instrumentation") (eq .registryType "application integration")) (.isNative) }} {{ $isFirstParty := and (or (eq .registryType "instrumentation") (eq .registryType "application integration")) (.isFirstParty) }} - {{ $currentTime := (time now) -}} - {{ $delta := $currentTime.Sub (time.AsTime .createdAt) -}} - {{ $isNew := lt $delta.Hours 730 -}} - {{ $usedInDemo := and (isset . "urls") (isset .urls "demo") }} - {{ $deprecated := and (isset . "deprecated") (isset .deprecated "reason") }} - {{ $package := "" -}} - {{ if and (.package) (isset $remoteRegistries .package.registry) -}} - {{ $package = merge .package (index $remoteRegistries .package.registry) -}} - {{ $package = merge $package (dict "type" .registryType) -}} - {{ end -}} - {{ $highlightStyle := "" -}} - {{ if $isNew -}} - {{ $highlightStyle = "border-info" -}} - {{ end -}} - {{ if $isNative -}} - {{ $highlightStyle = "border-success" -}} - {{ end -}} - {{ if $isFirstParty -}} - {{ $highlightStyle = "border-success" -}} - {{ end -}} - {{ if $usedInDemo -}} - {{ $highlightStyle = "border-secondary" -}} - {{ end -}} - {{ if $deprecated -}} - {{ $highlightStyle = "border-danger" -}} - {{ end -}} - {{ $primaryUrl := "" -}} - {{ if .urls.repo -}} - {{ $primaryUrl = .urls.repo -}} - {{ else if .urls.website -}} - {{ $primaryUrl = .urls.website -}} - {{ else if .urls.docs -}} - {{ errorf "The %q registry entry requires a repo or website URL." .title }} - {{ end -}} - {{ $primaryHref := printf "href=%q" $primaryUrl | safeHTMLAttr -}} -
  • -
    +{{ $currentTime := (time now) -}} +{{ $delta := $currentTime.Sub (time.AsTime .createdAt) -}} +{{ $isNew := lt $delta.Hours 730 -}} +{{ $usedInDemo := and (isset . "urls") (isset .urls "demo") }} +{{ $deprecated := and (isset . "deprecated") (isset .deprecated "reason") }} +{{ $package := "" -}} +{{ if and (.package) (isset $remoteRegistries .package.registry) -}} +{{ $package = merge .package (index $remoteRegistries .package.registry) -}} +{{ $package = merge $package (dict "type" .registryType) -}} +{{ end -}} +{{ $highlightStyle := "" -}} +{{ if $isNew -}} +{{ $highlightStyle = "border-info" -}} +{{ end -}} +{{ if $isNative -}} +{{ $highlightStyle = "border-success" -}} +{{ end -}} +{{ if $isFirstParty -}} +{{ $highlightStyle = "border-success" -}} +{{ end -}} +{{ if $usedInDemo -}} +{{ $highlightStyle = "border-secondary" -}} +{{ end -}} +{{ if $deprecated -}} +{{ $highlightStyle = "border-danger" -}} +{{ end -}} +{{ $primaryUrl := "" -}} +{{ if .urls.repo -}} +{{ $primaryUrl = .urls.repo -}} +{{ else if .urls.website -}} +{{ $primaryUrl = .urls.website -}} +{{ else if .urls.docs -}} +{{ errorf "The %q registry entry requires a repo or website URL." .title }} +{{ end -}} +{{ $primaryHref := printf "href=%q" $primaryUrl | safeHTMLAttr -}} +
  • +

    - {{- .title | markdownify -}} + {{- .title | markdownify -}}
    {{ if $isNew -}} @@ -105,7 +106,7 @@

    OTel Demo {{ end -}} {{ if $deprecated -}} - deprecated + deprecated {{ end -}} {{ if .cncfProjectLevel -}} @@ -116,37 +117,38 @@

    - by - {{ range $index, $author := .authors -}} + by + {{ range $index, $author := .authors -}} {{ if $index }}, {{ end }} {{ if eq $author.name "OpenTelemetry Authors" -}} - 🔭 {{ $author.name }} 🔭 + 🔭 {{ $author.name }} 🔭 {{ else if isset $author "url" }} - {{ $href := printf "href=%q" $author.url | safeHTMLAttr -}} - {{ $author.name }} + {{ $href := printf "href=%q" $author.url | safeHTMLAttr -}} + {{ $author.name }} {{ else -}} - {{ $author.name -}} + {{ $author.name -}} + {{ end -}} {{ end -}} - {{ end -}}

    {{ if $deprecated -}} - + {{ end -}} {{- .description | markdownify -}}
    {{ with $package -}} - {{ if not (eq .quickInstall false) }} -
    Quick Install
    -

    {{ (partial .installTemplate .) | markdownify -}} -

    - {{ end -}} + {{ if not (eq .quickInstall false) }} +
    Quick Install
    +

    {{ (partial .installTemplate .) | markdownify -}} +

    + + {{ end -}} {{- end -}}
    @@ -167,7 +169,17 @@
    Quick Install
    {{ $languageNames.Get . | default (humanize .) }}
    - Language + {{ if eq (replace (lower .) " " "") "collector" }} + + Collector + + + {{ else }} + + {{ . }} + + {{ end }}

  • {{- end }} @@ -177,7 +189,9 @@
    Quick Install
    {{ . | humanize }}
    - Component + + Component + {{- end -}} @@ -187,7 +201,17 @@
    Quick Install
    {{ . }}
    - License + {{ if eq . "Commercial" }} + + License + + {{ else }} + + License + + {{ end }} {{- end -}} @@ -206,7 +230,10 @@
    Quick Install
    {{- end -}} {{ with $package -}} {{ $packageUrl := printf "href=%q" (printf .urlPattern .name) | safeHTMLAttr -}} -  Package Details ({{ .registry }}) + +  Package Details ({{ .registry }}) + {{- end -}} {{ with .urls.repo -}} {{ $icon := cond ( hasPrefix . "https://github.com/" ) "fa-brands fa-github" "fab fa-git-alt" -}} @@ -215,8 +242,9 @@
    Quick Install
    {{- end -}} {{ with .urls.demo -}} {{ $demoUrl := printf "href=%q" (printf .) | safeHTMLAttr -}} -  Demo Service +  Demo Service {{- end -}} - - - {{ end -}} + + +{{ end -}}